MarkItDown MCP Server

A Model Context Protocol (MCP) server that converts various file formats to Markdown using the MarkItDown utility.

Supported Formats

• PDF

• PowerPoint

• Word

• Excel

• Images (EXIF metadata and OCR)

• Audio (EXIF metadata and speech transcription)

• HTML

• Text-based formats (CSV, JSON, XML)

• ZIP files (iterates over contents)

Related MCP server: MarkItDown MCP Server

Installation

Installing via Smithery

To install MarkItDown MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @KorigamiK/markitdown_mcp_server --client claude

Manual Installation

1. Clone this repository

2. Install dependencies:

uv install

Usage

As MCP Server

The server can be integrated with any MCP client. Here are some examples:

Zed Editor

Add the following to your settings.json:

"context_servers": {
 "markitdown_mcp": {
 "settings": {},
 "command": {
 "path": "uv",
 "args": [
 "--directory",
 "/path/to/markitdown_mcp_server",
 "run",
 "markitdown-mcp"
 ]
 }
 }
}

Commands

The server responds to the following MCP commands:

• /md <file> - Convert the specified file to Markdown

Example:

/md document.pdf

Supported MCP Clients

Works with any MCP-compliant client listed at modelcontextprotocol.io/clients, including:

• Zed Editor

• Any other MCP-compatible editors and tools

License

MIT License. See LICENSE for details.

Acknowledgements

https://github.com/microsoft/markitdown#readme

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers