docx-forge-mcp

MCP server for Word document (.docx) creation and manipulation — the production-grade document automation tool for AI agents.

Generate contracts, reports, proposals, and compliance documents directly from agent workflows. No Word installation required.

Why docx-forge-mcp?

Word documents are the default format for contracts, compliance reports, legal agreements, and business proposals — especially in enterprise and government workflows. This MCP server gives AI agents the ability to produce and manipulate .docx files programmatically, without any Office installation, UI automation, or file format guesswork.

Only 1 competitor exists for Word document manipulation via MCP as of 2026. This server fills that gap with a production-quality, fully-tested implementation.

Tools

| Tool | Description | |------|-------------| | create_document | Create a new .docx from a title and markdown content | | read_document | Extract text, headings, paragraphs, and metadata from a .docx | | add_section | Append a new section (heading + body) to an existing .docx | | replace_text | Find and replace text — ideal for template variable substitution | | add_table | Insert a formatted table with bold headers into a .docx | | merge_documents | Combine multiple .docx files into one | | export_to_pdf | Convert .docx to PDF via LibreOffice or pandoc | | get_document_stats | Get word count, page estimate, section count, table count |

Install

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "docx-forge": {
      "command": "npx",
      "args": ["docx-forge-mcp"]
    }
  }
}

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "docx-forge": {
      "command": "npx",
      "args": ["docx-forge-mcp"]
    }
  }
}

Manual (Node.js)

npm install -g docx-forge-mcp
docx-forge-mcp

Usage Examples

Create a contract from a template

create_document(
  title="Service Agreement",
  content="# Parties\n\n**Client:** {{CLIENT_NAME}}\n**Provider:** Acme Corp\n\n## Scope of Work\n\n{{SCOPE}}\n\n## Payment\n\n{{PAYMENT_TERMS}}",
  outputPath="/tmp/contract.docx"
)

replace_text(filePath="/tmp/contract.docx", find="{{CLIENT_NAME}}", replace="TechCorp Ltd")
replace_text(filePath="/tmp/contract.docx", find="{{SCOPE}}", replace="Software development and consulting services.")
replace_text(filePath="/tmp/contract.docx", find="{{PAYMENT_TERMS}}", replace="Net 30 days. $15,000/month.")

export_to_pdf(filePath="/tmp/contract.docx", outputPath="/tmp/contract.pdf")

Build a structured report

create_document(
  title="Q1 2026 Performance Report",
  content="## Executive Summary\n\nRevenue grew 34% YoY.",
  outputPath="/tmp/report.docx"
)

add_section(
  filePath="/tmp/report.docx",
  heading="Revenue Breakdown",
  content="Product A: $450K\nProduct B: $320K\nServices: $180K",
  headingLevel=2
)

add_table(
  filePath="/tmp/report.docx",
  headers=["Product", "Q1 Revenue", "Growth"],
  rows=[["Product A", "$450K", "+41%"], ["Product B", "$320K", "+28%"], ["Services", "$180K", "+19%"]]
)

get_document_stats(filePath="/tmp/report.docx")

Read and inspect an existing document

read_document(filePath="/path/to/existing.docx")
# Returns: { text, paragraphs[], headings[], metadata: { wordCount, fileSizeBytes, ... } }

Merge chapter files into a book

merge_documents(
  filePaths=["/docs/ch1.docx", "/docs/ch2.docx", "/docs/ch3.docx"],
  outputPath="/docs/complete-manual.docx"
)

Markdown Support

create_document and add_section both accept markdown content:

| Markdown | Result | |----------|--------| | # Heading 1 | H1 heading | | ## Heading 2 | H2 heading | | **bold text** | Bold text | | *italic text* | Italic text | | - item | Bullet list item | | 1. item | Numbered list item | | --- | Horizontal divider | | Blank line | Paragraph break |

PDF Export

export_to_pdf requires a system-level converter. It tries in order:

1. LibreOffice (best fidelity) — sudo apt-get install libreoffice
2. pandoc — sudo apt-get install pandoc

If neither is available, the tool returns success: false with installation instructions. The source .docx file is always preserved.

Resources

| URI | Description | |-----|-------------| | docx-forge://usage-guide | Step-by-step guide with workflow examples |

Dependencies

• docx — .docx creation (no Office required)
• mammoth — .docx reading and text extraction
• @modelcontextprotocol/sdk — MCP protocol
• zod — Input validation

Requirements

• Node.js >= 18.0.0
• No Microsoft Word or Office installation required
• PDF export requires LibreOffice or pandoc (optional)

Development

git clone https://github.com/mdfifty50-boop/docx-forge-mcp
cd docx-forge-mcp
npm install
npm test        # Run test suite
npm start       # Start MCP server (stdio)

License

MIT — see LICENSE

Related MCP Servers

• agentic-observability-mcp — Trace, cost-track, and monitor agent actions
• agent-guard-mcp — Loop detection and circuit breakers
• compliance-shield-mcp — EU AI Act audit trails