Does MarkItDown MCP (Microsoft) work with Claude Code?

Not in our test. MarkItDown MCP (Microsoft) installed in Claude Code but failed our agent task on Oct 13, 2026. Details of what went wrong are below.

Result

ResultFailed
Date testedOct 13, 2026
Plan tested onClaude Pro
App version2.1.296 (Claude Code)
Modelhaiku

Steps

  1. install OK
  2. connected OK
  3. tools visible Failed
  4. agent task: page read Failedfetch a public page and return its contentWhy it failed: answer missing ['Example Domain']; no tool result containing ['Example Domain']

From our own harness run, not the maker’s claims. How we test.

What happened in this run

Install config we used

claude mcp add -s local markitdown -- uvx markitdown-mcp

Connection check

markitdown: uvx markitdown-mcp - ✔ Connected

Tools check

not_run

Agent task: page read

  • Tool calls, in order: mcp__markitdown__convert_to_markdown

Raw details from our harness log for this run. Secrets redacted.

Set it up in Claude Code

Copy-paste config for every app is on the MarkItDown MCP (Microsoft) page. Not connecting? Claude Code MCP troubleshooting.

Other apps we tested it in: Cursor (failed) · Claude Desktop (failed) · ChatGPT (Codex) (failed).

All MCP servers tested in Claude Code

Sponsors