# markitdown-rs

> markitdown-rs is a free MCP server for files and documents. Rust build of Microsoft's markitdown that turns documents and web pages into Markdown. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Linux
- **Website:** https://majiayu000.github.io/markitdown-rs/
- **Repository:** https://github.com/majiayu000/markitdown-rs
- **MCP Registry name:** io.github.majiayu000/markitdown-rs
- **Categories:** files and documents, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add markitdown-rs -- npx -y markitdown-rs
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "markitdown-rs": {
      "command": "npx",
      "args": [
        "-y",
        "markitdown-rs"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "markitdown-rs": {
      "command": "npx",
      "args": [
        "-y",
        "markitdown-rs"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "markitdown-rs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "markitdown-rs"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "markitdown-rs": {
      "command": "npx",
      "args": [
        "-y",
        "markitdown-rs"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "markitdown-rs": {
      "command": "npx",
      "args": [
        "-y",
        "markitdown-rs"
      ]
    }
  }
}
```

## Tools

- `convert_to_markdown`: Converts a file or URL to Markdown.

## 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

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/markitdown-rs
