Home / MCP / MarkItDown MCP Server
Converts PDFs, Office docs, images, audio, HTML, and text formats into Markdown via a single MCP server.
Configuration
View docs{
"mcpServers": {
"markitdown_mcp": {
"command": "uv",
"args": [
"--directory",
"/path/to/markitdown_mcp_server",
"run",
"markitdown"
]
}
}
}MarkItDown MCP Server converts a wide range of file formats into Markdown, enabling you to easily generate clean, reusable Markdown content from documents, slides, images with OCR/metadatas, audio transcripts, HTML, and more. This makes it simple to integrate rich content into your workflow and tooling that consume Markdown.
To use MarkItDown with an MCP client, connect the server as a context source and invoke the convert command from your client. A common workflow is to call the convert command with a target file and receive the resulting Markdown content.
Zed Editor integration example shows how you attach the MCP server to your editor. You configure a context server that points to the local runtime, so your editor can send a convert request to generate Markdown from your file.
Example usage in your MCP client: provide the convert command with the target file path to obtain Markdown output. For instance, you can convert a PDF, Word, PowerPoint, or image into Markdown depending on what you need to include in your document.
Prerequisites you should have before installing the MCP server: Node.js installed on your system, and uvx (the lightweight runtime you will use to run the MCP server). Ensure these are available in your command environment.
Install via Smithery to automatically wire up the MCP server for your client. Run the following command in your terminal:
npx -y @smithery/cli install @KorigamiK/markitdown_mcp_server --client claudeIf you prefer manual installation, follow these steps. First, clone the repository to your local machine. Then install the dependencies and start the server as described.
# Step 1: Clone the repository
# (Replace with the actual repository URL when available)
git clone <repository-url> markitdown_mcp_server
# Step 2: Install dependencies
uv install
# Step 3: Run the MCP server (example invocation shown in the integration section of your client)
# The exact start command is provided in the client configuration when you set up the serverThe MCP server is designed to be connected via an MCP client and exposed through either a local stdio command or a remote HTTP endpoint, depending on your setup. The practical, explicit configuration shown in your client demonstrates how to launch the server locally.
An example local runtime configuration using a stdio connection is shown in the editor settings. You point the client at your local runtime, pass the directory where the MCP server runs, and start the specific conversion tool.
Commonly supported conversions include PDFs, Word, PowerPoint, Excel, images (with EXIF data and OCR), audio (with metadata and transcription), HTML, text-based formats (CSV, JSON, XML), and ZIP archives (iterates over contents). You can also convert from HTML and plain text formats via the same workflow.
The MCP server accepts a conversion command to produce Markdown from a given file. Use the designated MCP command provided by your client to request Markdown output for a specific file.
/md document.pdfTransforms a wide range of input formats into Markdown by extracting text, metadata, OCR, or speech as needed and producing a Markdown representation.