Documentero

List Documentero templates, inspect field schemas, and generate Word/PDF/Excel documents.

OtherTypeScriptv0.1.2

@documentero/mcp

Official MCP server for Documentero — list templates, inspect field schemas, and generate Word/PDF/Excel documents from AI agents (Cursor, Claude Desktop, and more).

Tools

ToolDescription
list_templatesTemplates with kind (word|excel), defaultFormat, allowedFormats
get_template_fieldsJSON Schema (primary, enriched value rules) + field definitions + allowed formats
generate_documentGenerate Word/PDF or Excel document for given template and fields; signed URL (~1h) by default, or base64 if embed: true. format optional (template default).

Setup

  1. Copy your API key from Documentero → Account settings.
  2. Add the MCP server to your client config.

Cursor / Claude Desktop (npx)

{
  "mcpServers": {
    "documentero": {
      "command": "npx",
      "args": ["-y", "@documentero/mcp"],
      "env": {
        "DOCUMENTERO_API_KEY": "your-api-key"
      }
    }
  }
}

Local development

git clone https://github.com/documentero/documentero-mcp.git
cd documentero-mcp
npm install
npm run build
{
  "mcpServers": {
    "documentero": {
      "command": "node",
      "args": ["/absolute/path/to/documentero-mcp/dist/index.js"],
      "env": {
        "DOCUMENTERO_API_KEY": "your-api-key",
        "DOCUMENTERO_BASE_URL": "https://app.documentero.com/api"
      }
    }
  }
}

Use https://documentero-dev.web.app/api for the development environment.

Environment

VariableRequiredDefaultDescription
DOCUMENTERO_API_KEYyes—Company API key (Account settings)
DOCUMENTERO_BASE_URLnohttps://app.documentero.com/apiCloud API base URL

Typical agent flow

  1. list_templates → pick a templateId (respect kind / allowedFormats)
  2. get_template_fields → shape data from jsonSchema (use fieldDefinitions for extra context like HTML/Markdown/image/link/QR rules)
  3. generate_document → download URL (or embedded base64)

Smoke test

npm run build
DOCUMENTERO_API_KEY=your-key npm run smoke

Notes

  • Thin client of the public Cloud API (/api/templates, /api/meta, /api/generate). Quotas and rate limits are enforced by Documentero as usual.
  • Do not put the API key in tool arguments — keep it in MCP env only.
  • Word templates support output format: docx / pdf; Excel templates support output format: xlsx only.
  • Remote Streamable HTTP hosting (https://mcp.documentero.com/mcp) is planned; this release is stdio only.

License

MIT © Documentero

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @documentero/mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-documentero-documentero-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@documentero/mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@documentero/mcpnpm

Compatible MCP Clients

Documentero works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More