Markitdown

🚀 MarkItDown MCP Server

A Model Context Protocol (MCP) server that uses the MarkItDown tool to convert various file formats to Markdown.

🚀 Quick Start

MarkItDown MCP Server is a powerful tool for converting multiple file formats to Markdown. It supports a wide range of formats and can be integrated with different MCP clients.

✨ Features

Supported Formats

• PDF
• PowerPoint
• Word
• Excel
• Images (EXIF metadata and OCR)
• Audio (EXIF metadata and speech transcription)
• HTML
• Text formats (CSV, JSON, XML)
• ZIP files (traverse contents)

📦 Installation

Install via Smithery

To automatically install the MarkItDown MCP server for Claude Desktop via Smithery:

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

Manual Installation

1. Clone this repository.
2. Install the dependencies:

uv install

💻 Usage Examples

As an MCP Server

This 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"
      ]
    }
  }
}

Supported MCP Clients

Use it with any MCP-compliant client, including:

• Zed Editor
• Any other MCP-compatible editors and tools. See modelcontextprotocol.io/clients for details.

📄 License

This project is licensed under the MIT License. See LICENSE for details.

Acknowledgments

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