MCP server/file-management

md2doc MCP Server

An MCP server that converts Markdown text to DOCX format

★ 6Yorick-Ryu/md2doc-mcp ↗by Yorick-Ryuupdated
1

Add it to Claude Code

claude mcp add -e "DEEP_SHARE_API_KEY=${DEEP_SHARE_API_KEY}" md2doc -- uvx md2doc
Required:DEEP_SHARE_API_KEY+ 1 optional
2

Make your agent remember this setup

md2doc's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.

npx conare@latest

Free · one command · indexes the sessions already on disk. Set up in the browser instead →

What it does

  • Convert Markdown text to DOCX format
  • Support for custom document templates
  • Multi-language support for document generation
  • Automatic file download to local directory or remote link generation
  • Template listing and management

Tools 2

convert_markdown_to_docxConvert markdown text to DOCX
list_templatesGet available templates by language

Environment Variables

DEEP_SHARE_API_KEYrequiredAPI key for the conversion service
MCP_SAVE_REMOTESet to true to return a download link instead of saving locally

Try it

Convert the following markdown text into a professional DOCX document: [paste markdown content]
List all available document templates for Chinese language.
Convert my project documentation to a DOCX file using the 'standard' template.
Generate a DOCX file from this markdown and provide me with a download link.
Original README from Yorick-Ryu/md2doc-mcp

md2doc - Markdown to DOCX MCP Server

A Model Context Protocol (MCP) server that converts Markdown text to DOCX format using an external conversion service.

Features

  • Convert Markdown text to DOCX format
  • Support for custom templates
  • Multi-language support (English, Chinese, etc.)
  • Automatic file download to user's Downloads directory
  • Template listing and management

Usage

Cherry Studio

  1. Open Cherry Studio
  2. Go to Settings → MCP
  3. Add the server configuration:
    {
      "mcpServers": {
        "md2doc": {
          "command": "uvx",
          "args": ["md2doc"],
          "env": {
            "DEEP_SHARE_API_KEY": "your-api-key-here"
          }
        }
      }
    }
    

Claude Desktop

  1. Open your Claude Desktop configuration file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Add the md2doc server:

    {
      "mcpServers": {
        "md2doc": {
          "command": "uvx",
          "args": ["md2doc"],
          "env": {
            "DEEP_SHARE_API_KEY": "your-api-key-here"
          }
        }
      }
    }
    
  3. Restart Claude Desktop

Command Line (Quick Start)

For immediate use without any client setup:

# Install and run the server
uvx md2doc

# Or with environment variable
DEEP_SHARE_API_KEY="your-api-key-here" uvx md2doc

Python Integration

You can also use md2doc directly in your Python projects:

import asyncio
from md2doc.api_client import ConversionAPIClient
from md2doc.models import ConvertTextRequest

async def convert_markdown():
    client = ConversionAPIClient()
    
    request = ConvertTextRequest(
        content="# Hello World

This is **markdown** content.",
        filename="example",
        language="zh",
        template_name="templates",
        remove_hr=False,
        compat_mode=True
    )
    
    response = await client.convert_text(request)
    if response.success:
        print(f"File saved to: {response.file_path}")

# Run the conversion
asyncio.run(convert_markdown())

Other MCP Clients

The server works with any MCP-compatible client. Configure it to run:

uvx md2doc

With environment variables:

DEEP_SHARE_API_KEY="your-api-key-here" uvx md2doc

Cloud Deployment (Remote Server)

When deploying this MCP server on a cloud server (VPS/Docker), set MCP_SAVE_REMOTE=true to return a temporary download link instead of saving to a local directory:

# In your cloud environment
export DEEP_SHARE_API_KEY="your-api-key-here"
export MCP_SAVE_REMOTE=true

uvx md2doc

The server will provide a download link for the converted document.

API Key

Free Trial API Key

Use this key for testing:

f4e8fe6f-e39e-486f-b7e7-e037d2ec216f

Purchase API Key - Super Low Price!

Available Tools

  • convert_markdown_to_docx: Convert markdown text to DOCX
  • list_templates: Get available templates by language

License

MIT

Frequently Asked Questions

What are the key features of md2doc?

Convert Markdown text to DOCX format. Support for custom document templates. Multi-language support for document generation. Automatic file download to local directory or remote link generation. Template listing and management.

What can I use md2doc for?

Converting technical documentation written in Markdown to professional Word documents for clients.. Automating the creation of reports from Markdown-based notes.. Generating localized documents using specific language templates.. Providing remote teams with direct download links for converted documentation..

How do I install md2doc?

Install md2doc by running: uvx md2doc

What MCP clients work with md2doc?

md2doc works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Conare · memory for coding agents

Turn this server into reusable context

Keep md2doc docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Set up free$npx conare@latest