Document MCP Server

Convert documents to Markdown using MarkItDown

Local serverstdioPython

What is the Document MCP Server?

Convert documents to Markdown using MarkItDown

The short version

Convert documents to Markdown inside Cursor, VS Code, and any MCP client.

Once connected, your agent converts files locally and returns structured text — nothing is sent to a conversion API.

  • 🏠 Local-first — files stay on your machine; no third-party conversion service
  • 📎 Broad format coverage — PDF, Office, CSV/JSON/text, Outlook .msg, audio, YouTube, and more (via MarkItDown)
  • 🔀 Two workflows — save Markdown next to the source, or preview in chat only
  • 📋 Copy-paste setup — step-by-step install for Cursor, VS Code, and Claude Desktop
  • 📦 Registry published — listed on the official MCP Registry
  • ⚖️ MIT licensed — free for personal and commercial use

The tools it exposes

The server publishes 2 tools. What each one is for:

  • convert_to_markdown — Converts a file or URL to Markdown and saves output (.md beside source, or youtube-{id}.md for YouTube URLs)
  • preview_markdown — Returns Markdown in the chat response only

What it needs from you

  1. Install uv (includes uvx). Windows (PowerShell): macOS / Linux: 2. Verify uvx works (open a new terminal after installing): 3. Optional — test the server (it will sit idle with no output; that is normal for stdio MCP): Press Ctrl+C to stop. ---

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
convert_to_markdownConverts a file or URL to Markdown and saves output (.md beside source, or youtube-{id}.md for YouTube URLs)
preview_markdownReturns Markdown in the chat response only

Configuration

  1. Install uv (includes uvx). Windows (PowerShell): macOS / Linux: 2. Verify uvx works (open a new terminal after installing): 3. Optional — test the server (it will sit idle with no output; that is normal for stdio MCP): Press Ctrl+C to stop. ---
VariableDescriptionRequired
REPO_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • “Use Document to convert to markdown.”
  • “Use Document to preview markdown.”

Frequently asked questions

Convert documents to Markdown using MarkItDown Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.