
markitdown-rs
Rust build of Microsoft's markitdown that turns documents and web pages into Markdown
- Pricing
- Free
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.2.1
- Listing updated
- 3 days ago
About markitdown-rs
markitdown-rs is a free MCP server for files and documents. It runs locally on your machine and is started by your AI client.
The project reproduces markitdown's output rather than improving it, quirks included, so the binary can be swapped in without changing downstream pipelines. Its tests compare 406 files against Python markitdown 0.1.9 and report 401 byte-identical, and the formats include PDF, Word, PowerPoint, Excel, HTML, EPUB, Outlook, CSV, ZIP, RSS and Jupyter, plus URLs, Wikipedia and YouTube transcripts.
The selling point is size and speed: a 4.5 MB binary instead of a 328 MB Python environment, and a median 408 times faster from the command line on 231 files by the project's own Apple Silicon benchmark. Install with brew install majiayu000/tap/markitdown-rs or cargo install markitdown-rs.
For agents, markitdown mcp serves a convert_to_markdown tool over stdio, or over Streamable HTTP and SSE with --http. A Python package of the same name keeps the markitdown API and plugins, and uses the markitdown-mcp command for MCP.
Install
Run in a terminal
claude mcp add markitdown-rs -- npx -y markitdown-rsAdd to claude_desktop_config.json
{
"mcpServers": {
"markitdown-rs": {
"command": "npx",
"args": [
"-y",
"markitdown-rs"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"markitdown-rs": {
"command": "npx",
"args": [
"-y",
"markitdown-rs"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"markitdown-rs": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"markitdown-rs"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"markitdown-rs": {
"command": "npx",
"args": [
"-y",
"markitdown-rs"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"markitdown-rs": {
"command": "npx",
"args": [
"-y",
"markitdown-rs"
]
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- convert_to_markdown
- Converts a file or URL to Markdown.
What it does
- Broad format support
- Converts office files, PDFs, HTML, EPUB, email, archives and URLs.
- Output parity
- Matches Python markitdown byte for byte on most test files.
- Single binary
- No Python environment needed for the CLI.
- Stdio or HTTP MCP
- Serves convert_to_markdown locally or over Streamable HTTP.
- Python package
- Keeps markitdown's API on the Rust converters.
- Web and video sources
- Handles Wikipedia and YouTube pages with transcripts.
Good for
- Let an agent read a PDF or spreadsheet as Markdown
- Prepare documents for a RAG pipeline
- Convert files in CI without a Python setup
- Swap in a faster converter without changing output
Pricing
Free
Free to install
Prices change. Check majiayu000.github.io before you buy.
markitdown-rs FAQ
How is it installed?
With Homebrew or cargo install, or prebuilt binaries for macOS and Linux x86_64.
How do I start the MCP server?
Run markitdown mcp, or add --http --port 3001 for HTTP.
Is the output identical to Microsoft's?
401 of 406 test files are byte-identical.
Are the speed figures general?
They come from the project's benchmark on 231 files on Apple Silicon.
Is markitdown-rs free?
Yes. markitdown-rs is free to use.
How do I add markitdown-rs to Claude Code?
Run this command in your terminal: claude mcp add markitdown-rs -- npx -y markitdown-rs
What are the best alternatives to markitdown-rs?
The closest alternatives to markitdown-rs are Claude Code Ultimate Guide, ASTra, CARTESIAN ECU, Invoices and SigPen.
Alternatives to markitdown-rs

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents
Invoices
MCP serverMCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files
- 4 tools
- Remote
- Paid
- Files and documents

SigPen
MCP serverMCP server that drafts e-signature documents while you approve every send
Not checked yet- 13 tools
- Remote
- Freemium
- Files and documents

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media