MarkItDown MCP (Microsoft) not working in Claude Desktop? Fixes

Failed It failed in our test on Oct 14, 2026. Below is the exact setup we used in Claude Desktop (Claude Desktop 2.37337.1 (Linux beta)), every error we saw, and what to check, all from our own run log.

Date tested: · From our harness, not the maker’s claims · How we test

1. Use the install config we tested in Claude Desktop

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

Replace any <YOUR_…> placeholder and local test paths with your own. Every client’s tested snippet is on the MarkItDown MCP (Microsoft) page.

2. Check that Claude Desktop connects to it

In our run the connect check was OK (connected in 2.7s). Our check output:

initialize seen in tee log after app restart

Errors we observed

  • agent task: page read: no tool result containing ['Example Domain']

Quoted from our run log. Secrets redacted. We list only what we saw.

More help

MarkItDown MCP (Microsoft): all results and setup · Full Claude Desktop run · General Claude Desktop MCP troubleshooting

Featured