Skip to main content
MCP server CX Codex

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 GitHub

What 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.txt to markdown and split it into sections.
  • Call convert_to_markdown on that address and write the output to notes.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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open