A
licenseA
qualityA
maintenancePrivacy-first local document search using semantic search. Runs entirely on your machine with no cloud services, supporting PDF, DOCX, TXT, and Markdown files.
22
9
3,331
386
MIT
markitdown-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@markitdown-mcpconvert this PDF to markdown and store it"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
markitdown-mcp
MCP server that converts documents to Markdown. Stateless — no database, no storage.
Tool
process_document
Converts a local file to Markdown and returns the content directly.
Input
Parameter | Type | Required | Description |
| string | yes | Absolute path to the file |
Output
{
"filename": "report.pdf",
"markdown": "# Report\n...",
"markdown_size_bytes": 4821
}Supported formats: PDF, DOCX, XLSX, PPTX, HTML, TXT, MD
Related MCP server: document-converter-mcp
Installation
1. Clone the repository
git clone https://github.com/alfredoanton82/markitdown-mcp.git ~/.claude/skills/markitdown-mcp
cd ~/.claude/skills/markitdown-mcp2. Create the virtual environment and install dependencies
bash setup.shAdd to Claude Code
Add this block to ~/.claude/.mcp.json:
{
"mcpServers": {
"markitdown": {
"command": "/Users/<your-user>/.claude/skills/markitdown-mcp/venv/bin/python",
"args": ["/Users/<your-user>/.claude/skills/markitdown-mcp/mcp_server.py"],
"type": "stdio"
}
}
}Windows paths:
{
"mcpServers": {
"markitdown": {
"command": "C:\\Users\\<your-user>\\.claude\\skills\\markitdown-mcp\\venv\\Scripts\\python.exe",
"args": ["C:\\Users\\<your-user>\\.claude\\skills\\markitdown-mcp\\mcp_server.py"],
"type": "stdio"
}
}
}Add to Claude Desktop
Edit the Claude Desktop config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"markitdown": {
"command": "/Users/<your-user>/.claude/skills/markitdown-mcp/venv/bin/python",
"args": ["/Users/<your-user>/.claude/skills/markitdown-mcp/mcp_server.py"]
}
}
}Windows:
{
"mcpServers": {
"markitdown": {
"command": "C:\\Users\\<your-user>\\.claude\\skills\\markitdown-mcp\\venv\\Scripts\\python.exe",
"args": ["C:\\Users\\<your-user>\\.claude\\skills\\markitdown-mcp\\mcp_server.py"]
}
}
}Restart Claude Desktop after editing the config.
Requirements
Python 3.10+
No API keys or credentials needed
This server cannot be installed
Maintenance
ActivityInactive
ResponsivenessNo issues
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Convert documents and web pages to clean Markdown: PDF, DOCX, XLSX, EPUB, scanned files, any URL.
Convert PDF, DOCX, HTML, and URLs to clean, LLM-ready markdown with tables preserved
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Parse PDF/Word/PPT/HTML to Markdown; tables as JSON, image extraction, RAG chunking, page ranges.
Related MCP Servers
- AlicenseAqualityBmaintenanceConverts documents between Markdown, PDF, DOCX, and HTML locally with AI-friendly Markdown output and secure file access.69MIT
- AlicenseNot gradedqualityAmaintenanceConverts documents (PDF, DOCX, XLSX, EPUB, etc.) to clean, structured Markdown, and retrieves document info, for use with AI agents.MIT
- AlicenseNot gradedqualityCmaintenanceConverts PDFs, Office files, spreadsheets, emails, audio, and more to Markdown locally, enabling AI assistants to read and process them without cloud upload.MIT
