MarkItDown MCP (Microsoft)

Description written after our first hands-on test.

🔎 Web search & scraping★ 190,065Updated 2026-10-04Auth: noneGitHub ↗

Test results

No full client pass yet

Claude CodeFailed2026-10-13 · agent task (answer missing ['Example Domain']; no tool result containing ['Example Domain'])

CursorFailed2026-10-13 · agent task (no tool result containing ['Example Domain'])

Claude DesktopFailed2026-10-14 · agent task (no tool result containing ['Example Domain'])

ChatGPT (Codex)Failed2026-10-14 · agent task (answer missing ['Example Domain']; no tool result containing ['Example Domain'])

Protocol: starts, 1 tools listed · 2026-10-13

Install

claude mcp add markitdown -- uvx markitdown-mcp

Run in your terminal. This exact command is what our harness runs in Claude Code; see the results above.

{
  "mcpServers": {
    "markitdown": {
      "command": "uvx",
      "args": [
        "markitdown-mcp"
      ]
    }
  }
}

Save as .cursor/mcp.json. This exact config is what our harness runs in Cursor; see the results above.

{
  "mcpServers": {
    "markitdown": {
      "command": "uvx",
      "args": [
        "markitdown-mcp"
      ]
    }
  }
}

Add to claude_desktop_config.json and restart Claude Desktop. Tested on the Linux beta; see the results above.

[mcp_servers.markitdown]
command = "uvx"
args = ["markitdown-mcp"]

Add to ~/.codex/config.toml (shared by the ChatGPT (Codex) CLI and the ChatGPT desktop app; Codex runs inside the ChatGPT desktop app). Tested with the ChatGPT (Codex) CLI bundled in the ChatGPT desktop app; see the results above.

Not connecting? Troubleshooting: Claude Code · Cursor · Claude Desktop · ChatGPT (Codex)

Test history

Date	Check	Result	Version
2026-10-13	Protocol (direct stdio)	Protocol: starts, 1 tools listed
2026-10-13	Claude Code	Failed agent task (answer missing ['Example Domain']; no tool result containing ['Example Domain'])	2.1.296 (Claude Code)
2026-10-13	Cursor	Failed agent task (no tool result containing ['Example Domain'])	2026.10.12-d47ca18
2026-10-14	Claude Desktop	Failed agent task (no tool result containing ['Example Domain'])	Claude Desktop 2.37337.1 (Linu
2026-10-14	ChatGPT (Codex)	Failed agent task (answer missing ['Example Domain']; no tool result containing ['Example Domain'])	codex-cli 0.162.0-alpha.17.2

Tools seen by our harness (1)

convert_to_markdown