Skip to main content

MCP server for the Dokmatiq DocGen document generation API

Project description

Dokmatiq DocGen MCP Server

MCP (Model Context Protocol) server that exposes the Dokmatiq DocGen document generation API as tools for AI assistants like Claude.

Setup

Prerequisites

  • Python 3.10+
  • DocGen API key

Installation

pip install dokmatiq-docgen-mcp

Or install from source:

cd mcp
pip install -e .

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": "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.

Available Tools

Document Generation

Tool Description
generate_pdf_from_html Convert HTML to PDF
generate_pdf_from_markdown Convert Markdown to PDF
generate_document Generate with template, fields, watermark, output format
compose_document Compose multi-part document from sections
create_invoice Create ZUGFeRD-compliant invoice PDF

PDF Tools

Tool Description
merge_pdfs Merge multiple PDFs into one
extract_text_from_pdf Extract all text content
get_pdf_metadata Get title, author, page count
convert_to_pdfa Convert to PDF/A archival format
rotate_pdf Rotate pages

PDF Forms

Tool Description
inspect_pdf_form List form fields with types and values
fill_pdf_form Fill form fields

Digital Signatures

Tool Description
sign_pdf Digitally sign with PKCS#12 certificate
verify_pdf_signatures Verify existing signatures
list_certificates List uploaded certificates

Templates & Fonts

Tool Description
list_templates List uploaded templates
upload_template Upload ODT/DOCX template
delete_template Delete a template
list_fonts List uploaded fonts

Preview

Tool Description
preview_pdf_page Render page as PNG image
get_pdf_page_count Get total page count

Excel Workbooks

Tool Description
generate_excel Generate styled XLSX from structured JSON (sheets, columns, formulas, styling, freeze panes)
csv_to_excel Convert CSV to formatted Excel with auto-filter and styled headers
excel_to_csv Extract Excel sheet data as CSV
excel_to_json Extract Excel sheet data as structured JSON with typed values
fill_excel_template Fill Excel template with values at named cells and ranges
inspect_excel Inspect workbook metadata (sheet names, row/column counts, named ranges)

E-Invoicing

Tool Description
validate_zugferd Validate ZUGFeRD compliance
extract_zugferd Extract invoice data from ZUGFeRD PDF
validate_xrechnung Validate XRechnung XML
parse_xrechnung Parse XRechnung into structured data
detect_xrechnung Detect XRechnung format

Receipt Recognition (AI-Powered)

Tool Description
extract_receipt Extract structured data from receipt image (vendor, totals, VAT, line items, SKR03/04 account)
extract_receipt_async Submit receipt for async extraction with optional webhook
get_receipt_job Check async extraction job status
get_receipt_job_result Get extraction result of completed job
list_receipt_jobs List all async receipt jobs
receipt_to_document Extract receipt and generate expense report (PDF/DOCX/ODT)
export_receipts_csv Export receipts as DATEV-compatible CSV
export_receipts_xlsx Export 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dokmatiq_docgen_mcp-0.1.0.tar.gz (9.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dokmatiq_docgen_mcp-0.1.0-py3-none-any.whl (9.8 kB view details)

Uploaded Python 3

File details

Details for the file dokmatiq_docgen_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: dokmatiq_docgen_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 9.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for dokmatiq_docgen_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 229b8332cc3da6ae925879d185599b1f758ebc0fe12d4d2d10046290a448d59e
MD5 4c0d7fe2f00ad18f1bb42060378ff174
BLAKE2b-256 c030550ae9e50fc6878f9ad7e762eacc21e538c8f81147e5107669f28639b989

See more details on using hashes here.

File details

Details for the file dokmatiq_docgen_mcp-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for dokmatiq_docgen_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ca5f27a5463604df04603bc56306de2b9b71269d6d4959659f4e72e4fe602545
MD5 48292ec93214bb3e70b764188a9682ed
BLAKE2b-256 a2b68ce985236d840c7bbd8c87d2ef0893a258d21183db95c33004e303a77ff2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page