KorigamiK/markitdown_mcp_server
Built by Metorial, the integration platform for agentic AI.
Convert PDF to Markdown
Convert PowerPoint to Markdown
Convert Word to Markdown
Convert Excel to Markdown
Extract EXIF metadata from images
Perform OCR on images to Markdown
Extract speech transcription from audio files
Convert HTML to Markdown
Convert CSV to Markdown
Convert JSON to Markdown
Convert XML to Markdown
Iterate over contents of ZIP files and convert supported formats to Markdown
Server Summary
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- 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.