📌Overview

Purpose: To provide a Model Context Protocol (MCP) server that efficiently converts various file formats into Markdown format using the MarkItDown utility.

Overview: The MarkItDown MCP Server is designed to facilitate the transformation of multiple file types—including PDFs, PowerPoint presentations, and images—into Markdown, streamlining the process for developers and users who require Markdown conversion in their workflows.

Key Features:

• Multiple Format Support: Capable of converting various formats such as PDF, Word, Excel, HTML, and more into Markdown, catering to diverse user needs.

• Integration with MCP Clients: Compatible with any MCP-compliant client, enabling seamless integration into existing systems, enhancing versatility and accessibility.

---

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)

Installation

Installing via Smithery

To install MarkItDown MCP Server 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’s an example for 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"
      ]
    }
  }
}

Commands

The server responds to the following MCP command:

• /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
• Other MCP-compatible editors and tools

License

MIT License. See LICENSE for details.