Dokmatiq DocGen

io.github.dokmatiqPublished by GitHub account dokmatiqv0.1.3Updated Oct 24, 2026

Generate PDF, DOCX and Excel documents, e-invoices and signed PDFs, and recognize receipts.

VerifiedSTDIODesktop onlyProductivity & WorkflowFiles & StorageFinance

Overview

AI-generated overview

Lets an assistant generate PDF, DOCX and Excel documents, e-invoices and signed PDFs, and extract data from receipts.

What you can do
Wraps the Dokmatiq DocGen API as tools for creating documents: PDF from HTML or Markdown, templated documents, multi-part compositions, invoices, Excel workbooks and CSV conversions. It also handles PDF operations such as merging, text extraction, metadata, PDF/A conversion, rotation, form inspection and filling, and digital signing with PKCS#12 certificates. E-invoicing tools validate and parse ZUGFeRD and XRechnung, and receipt tools extract vendor, totals, VAT and line items from images, with DATEV or Excel exports.
When to use it
Useful when an assistant needs to produce finished business documents rather than just text: invoices, expense reports, letterhead documents, filled PDF forms, signed or archival PDFs, and structured Excel output. Also relevant for German e-invoicing compliance work and for turning receipt photos into bookkeeping data.
Requirements
Runs locally as a Python package (dokmatiq-docgen-mcp) over stdio, requiring Python 3.11 or newer. A Dokmatiq API key must be supplied in the DOCGEN_API_KEY environment variable; DOCGEN_BASE_URL can override the default API endpoint. Network access to the Dokmatiq API is needed.
Before you install
The server sends document content and uploaded files to the Dokmatiq API, so treat it as a third-party service. It requires the secret DOCGEN_API_KEY, which should be set in the environment rather than pasted literally into JSON configs. Tools can upload and delete templates, sign PDFs with certificates, and submit receipt images for extraction, so review actions that modify stored templates or transmit sensitive documents.

Installation

In SourceWeft

  1. Open Dokmatiq DocGen in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
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:

bash
cd mcppip 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:

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

Configuration

Set your API key as an environment variable:

bash
export DOCGEN_API_KEY=dk_live_xxx

Optionally override the base URL:

bash
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):

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

Or using uvx:

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

Usage with Claude Code

bash
claude mcp add docgen -- docgen-mcp

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

Usage with Codex

Install the companion skill:

bash
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):

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

ToolDescription
generate_pdf_from_htmlConvert HTML to PDF
generate_pdf_from_markdownConvert Markdown to PDF
generate_documentGenerate with template, fields, watermark, output format
compose_documentCompose multi-part document from sections
create_invoiceCreate ZUGFeRD-compliant invoice PDF

PDF Tools

ToolDescription
merge_pdfsMerge multiple PDFs into one
extract_text_from_pdfExtract all text content
get_pdf_metadataGet title, author, page count
convert_to_pdfaConvert to PDF/A archival format
rotate_pdfRotate pages

PDF Forms

ToolDescription
inspect_pdf_formList form fields with types and values
fill_pdf_formFill form fields

Digital Signatures

ToolDescription
sign_pdfDigitally sign with PKCS#12 certificate
verify_pdf_signaturesVerify existing signatures
list_certificatesList uploaded certificates

Templates & Fonts

ToolDescription
list_templatesList uploaded templates
upload_templateUpload ODT/DOCX template
delete_templateDelete a template
list_fontsList uploaded fonts

Preview

ToolDescription
preview_pdf_pageRender page as PNG image
get_pdf_page_countGet total page count

Excel Workbooks

ToolDescription
generate_excelGenerate styled XLSX from structured JSON (sheets, columns, formulas, styling, freeze panes)
csv_to_excelConvert CSV to formatted Excel with auto-filter and styled headers
excel_to_csvExtract Excel sheet data as CSV
excel_to_jsonExtract Excel sheet data as structured JSON with typed values
fill_excel_templateFill Excel template with values at named cells and ranges
inspect_excelInspect workbook metadata (sheet names, row/column counts, named ranges)

E-Invoicing

ToolDescription
validate_zugferdValidate ZUGFeRD compliance
extract_zugferdExtract invoice data from ZUGFeRD PDF
validate_xrechnungValidate XRechnung XML
parse_xrechnungParse XRechnung into structured data
detect_xrechnungDetect XRechnung format

Receipt Recognition (AI-Powered)

ToolDescription
extract_receiptExtract structured data from receipt image (vendor, totals, VAT, line items, SKR03/04 account)
extract_receipt_asyncSubmit receipt for async extraction with optional webhook
get_receipt_jobCheck async extraction job status
get_receipt_job_resultGet extraction result of completed job
list_receipt_jobsList all async receipt jobs
receipt_to_documentExtract receipt and generate expense report (PDF/DOCX/ODT)
export_receipts_csvExport receipts as DATEV-compatible CSV
export_receipts_xlsxExport receipts as Excel workbook

Example Prompts

Once connected, you can ask Claude:

  • "Generate a PDF from this HTML: <h1>Hello World</h1>"
  • "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

Source: mcp/README.md at commit 5d90266

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.1.3LatestSep 26, 2026
  2. v0.1.2Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts