Markdown To Docx

An MCP (Model Context Protocol) server that empowers your AI agents (like Claude Desktop or Cursor) to autonomously generate beautifully styled, production-ready Microsoft Word (.docx) documents from Markdown.

MCP Compatible Python FastMCP

🌟 The Concept: AI-Driven Document Formatting

Most AI agents can write text, but delivering a finished, clean, and properly formatted file is often a manual secondary step.

This MCP server bridges that gap. It gives your AI the ability to not only write your content but also fully control document styling. When the AI uses this tool, it can decide on fonts, header colors, margins, and typography directly through parameters. The result? A perfectly formatted Word document saved directly to your local drive, ready to be sent or presented.

No more copy-pasting raw text into Word and manually tweaking headers. Let the AI do the secretarial work.

✨ Features

• Markdown to DOCX Conversion: Seamlessly translates standard Markdown (including tables, lists, and code blocks) into native Word elements.
• Autonomous Styling: AI agents can dynamically inject style settings (font_family, h1_color, body_size_pt, etc.) via JSON parameters.
• Local File Saving: Generates the .docx file and saves it securely to your local machine (or any designated directory).
• FastMCP Integration: Built using the official mcp Python SDK for robust stdio communication with clients like Claude Desktop.

🚀 Installation

Option 1: Using uv (Recommended)

You don't even need to install it manually. Just use uvx:

uvx mcp-markdown-to-docx

Option 2: Standard Python installation

1. Clone the repository:

   git clone https://github.com/Baptiste4321/mcp-markdown-to-docx.git
   cd mcp-markdown-to-docx
   

2. Install the package: Ensure you have Python 3.10 or higher installed.

   pip install .
   

⚙️ Configuration (Claude Desktop)

To connect this tool to Claude Desktop, add the following configuration to your claude_desktop_config.json file.

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "markdown-to-docx": {
      "command": "uvx",
      "args": [
        "mcp-markdown-to-docx"
      ],
      "env": {
        "MARKDOWN_API_URL": "https://markdown-to-docx.pfoly.com",
        "MARKDOWN_API_KEY": "mkdn_votre_cle_api_secrete_ici"
      }
    }
  }
}

Security Note: To get an API Key, go to the web interface of your markdown-to-docx instance, open the Settings > "Sécurité & API", and click "Generate API Key". The key is only displayed once and stored securely via SHA-256 hash.

Note: If you installed it manually via pip instead of uv, change the command to mcp-markdown-to-docx and remove the args.

💬 Example Prompts

Once configured, simply talk to your AI Agent:

"Write a comprehensive report about the impact of AI on modern healthcare. Format the output as a Word document, use 'Montserrat' font, and make all main headers dark blue. Save it to my Desktop."

"Take these rough meeting notes, expand them into a professional meeting minutes document, and generate a DOCX file named 'Q3_Meeting_Minutes'."

📜 License

MIT License. Feel free to fork and modify!