mcp-docgen 0.1.0

Markdown-driven MCP server that generates Word (.docx), Excel (.xlsx) and PowerPoint (.pptx) documents — by the Touka project.

mcp-docgen

A Markdown-driven Model Context Protocol (MCP) server that turns Markdown — and structured data — into Word (.docx), PowerPoint (.pptx), and Excel (.xlsx) files.

Built entirely on mature, permissively-licensed Python libraries (python-docx, python-pptx, openpyxl, XlsxWriter, markdown-it-py) — no proprietary dependencies. MIT licensed.

Part of the Touka project: giving AI agents the ability to produce real Office documents using only open-source building blocks.

Why

LLMs are great at producing Markdown. mcp-docgen exposes three tools that convert that Markdown into polished Office documents, so any MCP-capable assistant (Claude Desktop, Touka, …) can hand a user a finished .docx / .pptx / .xlsx.

Install & run

Once published to PyPI:

uvx mcp-docgen

From a local checkout (before publishing):

uv sync
uv run mcp-docgen

The server speaks MCP over stdio.

MCP client configuration

{
  "mcpServers": {
    "docgen": {
      "command": "uvx",
      "args": ["mcp-docgen"],
      "env": { "MCP_DOCGEN_OUTPUT_DIR": "/absolute/path/to/output" }
    }
  }
}

From a local checkout, swap the command for:

{ "command": "uv", "args": ["run", "--directory", "/path/to/mcp-docgen", "mcp-docgen"] }

Tools

Each tool returns {"path": "<absolute path of the written file>"}.

create_docx(markdown, output_path, title?)

Markdown → Word. Supports headings, bold / italic / inline code, bullet and numbered lists (nested), tables, block quotes, fenced code blocks, and horizontal rules.

create_pptx(markdown, output_path, title?)

Markdown → PowerPoint, using this slide convention:

Markdown	Result
# Heading	starts a new slide (the heading becomes its title)
content below a heading	bullet points (nested lists indent)
--- (horizontal rule)	an explicit slide break

title adds a leading title slide.

create_xlsx(sheets, output_path)

Structured data → Excel. sheets is a list of worksheets:

[
  {
    "name": "Sales",
    "rows": [["Region", "Revenue"], ["APAC", 1200000], ["EMEA", 900000]],
    "header": true
  }
]

Cells may be strings, numbers, booleans, or null. The first row is a bold, frozen header unless the sheet sets "header": false.

Output directory & safety

All files are written inside one base directory — MCP_DOCGEN_OUTPUT_DIR, or ./out relative to the working directory by default. output_path is always interpreted relative to that base, and any path that tries to escape it (via .. or an absolute path) is rejected. The server makes no network calls and spawns no subprocesses.

Examples

uv run python examples/generate_samples.py
# writes report.docx, review.pptx and sales.xlsx into examples/output/

Development

uv sync
uv run pytest
uv run ruff check .

License

MIT © 2026 Touka Project — see LICENSE.

Document generation is powered by python-docx, python-pptx, openpyxl, and XlsxWriter; Markdown parsing by markdown-it-py. All MIT/BSD licensed.