# Markitdown

A local MCP server that wraps MarkItDown and gives the agent one tool, convert_to_markdown, turning a file or a URL into markdown.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: microsoft
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/microsoft/markitdown/tree/HEAD/packages/markitdown-mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/markitdown

## What it 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.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- 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
- 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.

## Similar
- [pdf-to-markdown](https://affpapa.org/en/nevibecode/skills/pdf-to-markdown.md) — skill · 870 installs
- [mcp-document-converter](https://affpapa.org/en/nevibecode/mcp/mcp-document-converter.md) — MCP server · ★ 12 repo stars
- [markitdown-skill](https://affpapa.org/en/nevibecode/skills/markitdown-skill.md) — skill · ★ 108 repo stars
- [doc-to-markdown](https://affpapa.org/en/nevibecode/skills/doc-to-markdown.md) — skill · 945 installs
- [pandoc](https://affpapa.org/en/nevibecode/skills/pandoc.md) — skill · 496 installs
- [document-converter-suite](https://affpapa.org/en/nevibecode/skills/document-converter-suite.md) — skill · 495 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
