GZLIAO/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 text from images using OCR
Transcribe audio to text
Convert HTML to Markdown
Process text-based formats (CSV, JSON, XML)
Extract and iterate contents of ZIP files
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.