markitdown_mcp_server
The MarkItDown MCP Server is a Model Context Protocol (MCP) server that converts various file formats into Markdown. This tool supports a wide range of file formats, including PDF, PowerPoint, Word, Excel, images, audio, HTML, and text-based formats like CSV, JSON, XML, and ZIP files. Implemented in Python, it integrates seamlessly with MCP clients to facilitate efficient file conversion. It is particularly useful in projects leveraging AI and LLMs for document formatting and data extraction.
GitHub Stars
45
User Rating
Not Rated
Forks
9
Issues
1
Views
0
Favorites
0
MarkItDown MCP Server
A Model Context Protocol (MCP) server that converts various file formats to Markdown using the MarkItDown utility.
Supported Formats
- 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.