Dokmatiq DocGen

Dokmatiq DocGen MCP Server

MCP (Model Context Protocol) server that exposes the Dokmatiq DocGen document generation API as tools for AI assistants like Codex, Claude Code, Claude Desktop, Cursor, Continue, Cline, and Hermes.

Use it to generate PDFs, DOCX/ODT documents, Excel workbooks, invoices, e-invoices (ZUGFeRD/XRechnung/Factur-X), receipt exports, signed PDFs, PDF forms, and documents on company letterhead (Briefpapier/Firmenpapier).

Setup

Prerequisites

• Python 3.11+
• DocGen API key

Installation

python3.11 -m pip install --user dokmatiq-docgen-mcp

The package requires Python 3.11 or newer. On macOS, the system or Xcode-provided python3 can be too old; use Homebrew Python, pyenv, uv, or another Python 3.11+ runtime if pip cannot find a compatible package.

pip install --user commonly installs the docgen-mcp command into ~/.local/bin. If your MCP client cannot find docgen-mcp, add ~/.local/bin to PATH or use the absolute command path in your MCP config.

Or install from source:

cd mcp

pip install -e .

Running tests

From the repository root, use the checked-in lockfile to install the MCP server and run its stdio/client smoke tests:

uv run --project mcp python -m unittest discover -s mcp/tests -v

Configuration

Set your API key as an environment variable:

export DOCGEN_API_KEY=dk_live_xxx

Optionally override the base URL:

export DOCGEN_BASE_URL=https://custom.api.endpoint.com

Usage with Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{

"mcpServers": { "docgen": { "command": "/Users/you/.local/bin/docgen-mcp", "env": { "DOCGEN_API_KEY": "dk_live_xxx" } } } }

Or using uvx:

{

"mcpServers": { "docgen": { "command": "uvx", "args": ["dokmatiq-docgen-mcp"], "env": { "DOCGEN_API_KEY": "dk_live_xxx" } } } }

Usage with Claude Code

claude mcp add docgen -- docgen-mcp

Set the API key in your environment or .env file.

Usage with Codex

Install the companion skill:

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \

--repo dokmatiq/docgen-sdks \ --path plugin/skills/dokmatiq-docgen

Then configure an MCP server named docgen using either docgen-mcp, an absolute path such as /Users/you/.local/bin/docgen-mcp, or uvx dokmatiq-docgen-mcp. Make sure DOCGEN_API_KEY is available to the server process.

Usage with Hermes

Add the MCP server to your Hermes config (~/.hermes/config.yaml):

mcp_servers:

docgen: command: "uvx" args: ["dokmatiq-docgen-mcp"] env: DOCGEN_API_KEY: "dk_live_xxx"

Replace dk_live_xxx with your Dokmatiq API key.

Environment Variables in MCP Configs

Do not use shell placeholders such as ${DOCGEN_API_KEY} inside JSON MCP config files unless your specific client documents that it expands them. Many MCP clients pass that value literally to the server, which causes authentication to fail.

Available Tools

Document Generation

PDF Tools

PDF Forms

Digital Signatures

Templates & Fonts

Preview

Excel Workbooks

E-Invoicing

Receipt Recognition (AI-Powered)

Example Prompts

Once connected, you can ask Claude:

• "Generate a PDF from this HTML: Hello World "
• "Create an invoice for ACME GmbH to Kunde AG for 8 hours of consulting at 120€/hour"
• "Merge these two PDFs together"
• "Extract the text from this PDF"
• "Fill the form fields name=Max and date=12.04.2026 in this PDF"
• "Extract the data from this receipt image -- I need vendor, total, and VAT breakdown"
• "Analyze these receipts and export them as a DATEV CSV"
• "Turn this receipt photo into an expense report PDF"

License

MIT