GZLIAO/markitdown_mcp_server
Built by Metorial, the integration platform for agentic AI.
Convert PDF to Markdown
Convert PowerPoint to Markdown
Convert Word documents to Markdown
Convert Excel spreadsheets to Markdown
Extract content from images and convert to Markdown
Transcribe audio content to Markdown
Convert HTML to Markdown
Process text-based formats like CSV, JSON, XML to Markdown
Iterate over ZIP files and convert their contents 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.