# 📄 MCP Markdown to DOCX Server

> **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](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io)
[![Python](https://img.shields.io/badge/Python-3.10+-yellow.svg)](https://python.org)
[![FastMCP](https://img.shields.io/badge/FastMCP-Enabled-green.svg)](https://github.com/jlowin/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`:
```bash
uvx mcp-markdown-to-docx
```

### Option 2: Standard Python installation
1. **Clone the repository:**
   ```bash
   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.
   ```bash
   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`

```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!