Skip to content
MCP server

markitdown-rs

Rust build of Microsoft's markitdown that turns documents and web pages into Markdown

Runs locallyStatus and history
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-rs

Add to claude_desktop_config.json

{
  "mcpServers": {
    "markitdown-rs": {
      "command": "npx",
      "args": [
        "-y",
        "markitdown-rs"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "markitdown-rs": {
      "command": "npx",
      "args": [
        "-y",
        "markitdown-rs"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. MCP 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
  2. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  3. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  4. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  5. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media