Markitdown — Claude Code MCP server: what it does, how to install
A local MCP server that wraps MarkItDown and gives the agent one tool, convert_to_markdown, turning a file or a URL into markdown.
no license updated 2026-10-29
Open on GitHubWhat Markitdown does
markitdown-mcp runs MarkItDown as an MCP server on your own machine. The agent gets a single tool, convert_to_markdown(uri), and that uri can point at a local file, an http: or https: address, or inline data:.
STDIO is the default transport. Start the server with markitdown-mcp and nothing else. Streamable HTTP and SSE need --http plus a host and port, as in markitdown-mcp --http --host 127.0.0.1 --port 3001. The repo ships a Dockerfile; files outside the container stay out of reach until you mount the directory with -v.
No authentication is built in, and the process runs as whoever started it. Whatever that user can read on disk or reach over the network is available to the tool. Pointing it at a non-localhost interface widens that reach to the whole network, so keep it on localhost unless it sits in a sandbox.
What it helps with
- convert a local file to markdown from inside the chat
- pull a page down as plain text for the agent
- wire the server into Claude Desktop through Docker
- debug a tool call in MCP Inspector
- pass inline
data:content with no temp file
Example prompts for the agent
- Convert
file:///workdir/notes.txtto markdown and split it into sections. - Call
convert_to_markdownon that address and write the output tonotes.md. - Read the document behind this
data:uri and list every date in it.
How to install Markitdown
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Markitdown
How do I install Markitdown?
Run pip install markitdown-mcp to get the package, then start the server with markitdown-mcp; STDIO is the default transport.
What does Markitdown do?
It exposes one tool, convert_to_markdown(uri), which takes an http:, https:, file: or data: uri and hands back markdown.
Does the server require authentication?
No. It runs with the privileges of the user who launched it, so it can read anything that user can, and it listens on localhost by default.