What is the MD2Doc MCP server?

MD2Doc's MCP server is a remote tool that AI agents like Claude Code can call to convert markdown text to Microsoft Word (.docx) files. It uses the Model Context Protocol (MCP) over SSE transport. No local installation is needed — the server runs on md2doc.com.

How do I add MD2Doc to Claude Code?

Run this command once in your terminal: claude mcp add --transport sse md2doc https://md2doc.com/mcp/sse — then restart Claude Code. After that, Claude can convert markdown to Word documents automatically when you ask.

Do I need an API key to use the MD2Doc MCP server?

No. The MD2Doc MCP server is free and requires no API key or authentication. Just add the server URL and start using it.

Which AI agents support the MD2Doc MCP server?

Any agent that supports MCP with SSE transport can use MD2Doc. This includes Claude Code, Claude Desktop, Cursor, Windsurf, Cline, and any tool using the MCP SDK.

What happens to my markdown content?

Your markdown is sent to md2doc.com for conversion, the .docx file is generated, stored temporarily for 10 minutes, and then deleted. No content is logged or stored permanently.

Convert Markdown to Word Inside Your AI Agent

MD2Doc's MCP server lets Claude Code, Cursor, Windsurf, and other AI agents convert markdown to Word documents directly — no browser, no copy-paste, no context switching.

claude mcp add --transport sse md2doc https://md2doc.com/mcp/sse

Free · No API key · Works instantly

Why Use MD2Doc via MCP?

The browser tool is great for one-off conversions. The MCP server is for developers and power users who work inside AI coding environments every day.

⚡

Zero Context Switching

Stay in Claude Code, Cursor, or Windsurf. Ask for a Word doc and get a download link without leaving your editor.

🤖

Fully Automated

Agents can convert markdown to Word as part of a larger task — writing documentation, generating reports, summarizing research — without any manual steps.

☁️

Nothing to Install Locally

The MCP server runs on md2doc.com. No binary, no Docker, no updates. Add the URL once and it just works — on every machine you use.

How It Works

Add the server once

Run the install command in your terminal. Takes 10 seconds. The URL is registered in your agent's config.

claude mcp add --transport sse md2doc https://md2doc.com/mcp/sse

Ask your agent naturally

No special syntax. Just describe what you want and the agent calls MD2Doc automatically.

"Convert this markdown to a Word file and save it to my Desktop"

Get a download link

MD2Doc converts the file server-side and returns a one-time download link. Valid for 10 minutes. Click and save.

https://md2doc.com/mcp/download/abc123

Installation by Agent

MD2Doc works with any MCP-compatible agent. Pick yours below.

Claude Code Recommended

Claude Code is Anthropic's official CLI. One command installs the server globally.

claude mcp add --transport sse md2doc https://md2doc.com/mcp/sse

Verify it's connected in any session with /mcp — md2doc should appear as connected.

Claude Desktop

Edit your Claude Desktop config file and add the md2doc server:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "md2doc": {
      "url": "https://md2doc.com/mcp/sse"
    }
  }
}

Restart Claude Desktop after saving.

Cursor

Add MD2Doc to your global Cursor MCP config. Create or edit the file:

~/.cursor/mcp.json

{
  "mcpServers": {
    "md2doc": {
      "url": "https://md2doc.com/mcp/sse"
    }
  }
}

Or add to a .cursor/mcp.json in your project directory for project-scoped access.

Windsurf

Edit the Windsurf MCP config file:

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "md2doc": {
      "url": "https://md2doc.com/mcp/sse"
    }
  }
}

Reload Windsurf after saving the config.

Hermes

Hermes connects to MCP servers over HTTP. Add MD2Doc to your mcp_servers block using the Streamable HTTP URL:

mcp_servers:
  md2doc:
    url: "https://md2doc.com/mcp"

No SSE support needed — md2doc serves the full MCP protocol over a single POST endpoint at /mcp.

OpenClaw

OpenClaw registers MCP servers from the CLI. One command and md2doc is available in any session:

openclaw mcp set md2doc '{"url":"https://md2doc.com/mcp/sse"}'

SSE is OpenClaw's default transport. To use Streamable HTTP instead, swap the URL to https://md2doc.com/mcp.

Any MCP-compatible agent

MD2Doc supports two MCP transports — pick whichever your agent speaks. SSE works with most established clients; Streamable HTTP is a single-URL transport for HTTP-only agents like Hermes.

SSE (Claude Code, Cursor, Windsurf, Cline, etc.):

https://md2doc.com/mcp/sse

Streamable HTTP (Hermes, custom HTTP clients):

https://md2doc.com/mcp

For JSON-based configs (Cline, Continue, Zed, etc.), add the server under "mcpServers" with the URL of your chosen transport.

Large Markdown Files

For markdown over ~50KB, agents can upload the file out-of-band so the contents never enter the agent's tool-call token budget. The agent runs one shell command, gets back a short ID, and passes that ID to convert_to_docx:

# 1. Upload (file bytes flow disk → server, agent never reads them)
curl -F file=@big.md https://md2doc.com/mcp/upload
# → {"id":"abc..."}

# 2. Call the tool with markdown_upload_id instead of markdown
convert_to_docx({ markdown_upload_id: "abc...", filename: "report" })

Upload IDs are single-use, max 5MB, and expire after 10 minutes.

Available Tools

The MD2Doc MCP server exposes two tools your agent can call:

convert_to_docx

Converts markdown to a Microsoft Word (.docx) file. Returns a temporary download URL valid for 10 minutes.

{
  "name": "convert_to_docx",
  "arguments": {
    "markdown": "# Title\n\nContent...",
    "filename": "my-report"
  }
}

Returns: download URL + file size

preview_markdown

Converts markdown to an HTML preview showing exactly how the Word document will look. Useful for agents that need to verify output before downloading.

{
  "name": "preview_markdown",
  "arguments": {
    "markdown": "# Title\n\nContent..."
  }
}

Returns: HTML string

What to Ask Your Agent

Once MD2Doc is connected, you can ask for Word documents naturally. Here are prompts that work well:

Convert this markdown to a Word file and save it to my Desktop
Take the output from Claude and turn it into a .docx I can send to my team
Write a project proposal in markdown and download it as a Word document
Summarize this research and export it as a formatted Word file
Convert my README.md to a Word document for the client presentation
Generate meeting notes from this transcript and download as .docx

Technical Details

Protocol

MCP (Model Context Protocol) v2024-11-05. Two transports supported: HTTP+SSE for streaming clients and Streamable HTTP for single-POST clients. Fully compatible with the official MCP specification.

Endpoints

# Streamable HTTP transport
POST /mcp

# SSE connection
GET  /mcp/sse

# Send JSON-RPC messages (SSE flow)
POST /mcp/messages?sessionId=X

# Out-of-band markdown upload
POST /mcp/upload

# Download generated file
GET  /mcp/download/{id}

Performance

Typical conversion time is under 2 seconds for documents up to 100KB of markdown. Generated .docx files are stored for 10 minutes then automatically deleted.

Privacy

Markdown content is sent to md2doc.com for conversion and is not logged or retained. Download links are single-use and expire after 10 minutes.

MCP FAQ

What is MCP and why does it matter?

MCP (Model Context Protocol) is an open standard from Anthropic that lets AI agents connect to external tools and services. Instead of describing how to use a tool, agents call it directly — like a function call. This makes workflows faster, more reliable, and fully automated.

Do I need an API key?

No. The MD2Doc MCP server is free and open. Just add the server URL and start using it. No registration, no credit card.

Which agents support MCP with SSE transport?

Claude Code, Claude Desktop, Cursor, Windsurf, Cline, and any agent built on the MCP SDK. The SSE transport is the standard for remote MCP servers — if an agent supports remote MCP at all, it supports this format.

What file formats does MD2Doc produce?

The convert_to_docx tool produces a standard .docx file compatible with Microsoft Word 2010 and later, Google Docs, LibreOffice, and all major document editors.

What markdown features are supported?

Headers (H1–H6), bold, italic, strikethrough, ordered and unordered lists, tables, fenced code blocks, inline code, blockquotes, and hyperlinks. The same features as the web converter.

Is there a rate limit?

Currently there is no rate limit for reasonable use. The service is designed for developer workflows and individual use. If you need high-volume conversion, contact us.

Can I use this in my own application?

Yes. The REST API at https://md2doc.com/convert and https://md2doc.com/download-docx are also available for programmatic use. See LLM.md for full API documentation.

Ready to Add MD2Doc to Your Agent?

One command. Free. No sign-up required.

claude mcp add --transport sse md2doc https://md2doc.com/mcp/sse

Or use the browser converter if you just need a quick one-off conversion.

Need higher concurrency or hitting a "server busy" error? DM @kirillzubovsky on X — we'll set up a dedicated account for you.