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 for Claude Desktop automatically via Smithery:

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

Manual Installation

Clone this repository
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"
      ]
    }
  }
}

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

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

Converts various file formats to Markdown using the MarkItDown utility and can be integrated with MCP clients for seamless document processing and conversion.

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-pandoc
vivekVells
A
security
A
license
A
quality
MCP server for seamless document format conversion using Pandoc, supporting Markdown, HTML, PDF, DOCX (.docx), csv and more.
Last updated -
1
212
Python
MIT License
markdown2pdf-mcp
2b3pro
A
security
F
license
A
quality
An MCP server for converting Markdown documents to PDF files.
Last updated -
1
1
JavaScript
Markdownify MCP Server
zcaceres
A
security
A
license
A
quality
Converts various file types and web content to Markdown format. It provides a set of tools to transform PDFs, images, audio files, web pages, and more into easily readable and shareable Markdown text.
Last updated -
10
2
1,611
TypeScript
MIT License
Markdownify MCP Server - UTF-8 Enhanced
JDJR2024
A
security
A
license
A
quality
A document conversion server that transforms various file formats (PDFs, documents, images, audio, web content) to Markdown with improved multilingual and UTF-8 support.
Last updated -
10
4
TypeScript
MIT License

View all related MCP servers

MarkItDown MCP Server