home / mcp / markitdown mcp server

MarkItDown MCP Server

Converts diverse file formats to Markdown via an MCP server for seamless integration with MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "korigamik-markitdown_mcp_server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/markitdown_mcp_server",
        "run",
        "markitdown-mcp"
      ]
    }
  }
}

MarkItDown MCP Server is an MCP server that converts a variety of file formats into Markdown using the MarkItDown utility. It enables you to feed documents, presentations, spreadsheets, images, audio, HTML, and text-based data through a single interface and receive clean Markdown output for easy integration with MCP clients and workflows.

How to use

You can run MarkItDown MCP Server locally and connect it to any MCP client. The server exposes a standard Markdown conversion endpoint that you can trigger with an MCP command to convert a specified file.

How to use

Configure your MCP client to communicate with the local server. If you are using Zed Editor, add the following server configuration to your settings so the editor can send files to be converted and receive Markdown output.

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

Commands

The MCP server accepts a command to convert a file to Markdown. Use the following command within your MCP client to convert a target file.

/md document.pdf

Supported MCP clients

The server works with any MCP-compliant client. Common examples include Zed Editor and other MCP-compatible editors and tools.

Notes on installation and runtime

You can install and run the server in two main ways. The Smithery approach installs the MCP server automatically for a Claude client, while the manual approach gives you direct control over the repository and runtime.

Additional guidance and usage examples

For local development, you can start the MCP server using the runtime command shown in the usage example. This keeps the server ready to handle MCP requests from your client applications.

Security and licensing

The server is provided under the MIT License. Use it in accordance with the license terms and ensure you follow your organization’s security practices when exposing local MCP endpoints.

Notes on supported formats

The server can convert PDFs, PowerPoint, Word, Excel, images (with EXIF or OCR), audio (with EXIF metadata and transcription), HTML, text-based formats like CSV, JSON, XML, and ZIP archives by iterating their contents.