DOCUMENT CONVERSION / Microsoft
MarkItDown MCP
Converts supported documents and web resources into Markdown through a local MCP tool.
“An MCP server for the "markitdown" library.”
01 / THE REASONING
Why this made the selection.
- Provides document ingestion across office files, PDFs and web resources without requiring a separate MCP server for each format.
- Its small tool surface is inspectable: conversion returns Markdown rather than offering a general file-editing API.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- packages/markitdown-mcp/README.md at 4cc9fa17653d695d64fb9eee5b33d4de55ff84e8: installation, transports, Docker, Claude Desktop and security sections.
- packages/markitdown-mcp/pyproject.toml at the same commit: Python requirement, dependencies, MIT licence field and console script.
- packages/markitdown-mcp/src/markitdown_mcp/__main__.py at the same commit: conversion tool, transport selection and plugin setting.
- README.md and packages/markitdown/src/markitdown/_markitdown.py at the same commit: conversion scope and resource-access boundary.
- LICENSE at the same commit: MIT terms.
Our findings
- convert_to_markdown passes the supplied URI to MarkItDown.convert_uri and returns the Markdown result; file and network permissions remain those of the server process.
- Plugins are disabled unless MARKITDOWN_ENABLE_PLUGINS is explicitly enabled.
- The HTTP entrypoint defaults to loopback and warns that exposing it gives reachable clients the server user’s file and network access.
- The MCP README says the package exposes one tool, convert_to_markdown(uri), for http:, https:, file: and data: URIs.
- configExample is the MCP README's Claude Desktop block at 4cc9fa17. It runs a markitdown-mcp:latest Docker image that the README has you build from the package's Dockerfile; it is not pulled from a registry.
- Between d51937de and 4cc9fa17 the MCP package files did not change; _markitdown.py changed only its stream-copy and download chunk size.
Not established by this review
- No server was started and no documents, URLs, plugins or conversion accuracy were tested.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Connect a server deliberately.
DOCUMENTED COMMAND
pip install markitdown-mcp Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- Install in an appropriate Python environment, then configure your MCP client to start markitdown-mcp for stdio.
- For the documented local HTTP alternative, run markitdown-mcp --http --host 127.0.0.1 --port 3001 and use a supported local transport.
- Restrict the process permissions, mounted files and allowed inputs to the documents you intend to convert.
- For Claude Desktop the README recommends its Docker image: build it with docker build -t markitdown-mcp:latest . and mount only the directory you want converted. Local files are reachable only through the mount.
- The command was copied from the README and not run.
Before you start
- Python satisfying the package requirement and pip; the package installs its declared conversion dependencies.
- Read access to selected local documents or network access to the intended URLs.
Documented configuration example
Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.
{
"mcpServers": {
"markitdown": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"markitdown-mcp:latest"
]
}
}
} 04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/packages/markitdown-mcp/README.md
Supports: summary, whySelected, bestFor, install, compatibility, transports, limitations, access, configExample
- Python package manifest ↗Checked
https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/packages/markitdown-mcp/pyproject.toml
Supports: upstreamDescription, descriptionSourceUrl, language, install.prerequisites, review
https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/packages/markitdown-mcp/src/markitdown_mcp/__main__.py
Supports: review, transports, access, limitations
https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/README.md
Supports: summary, bestFor, whySelected, limitations, access
https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/packages/markitdown/src/markitdown/_markitdown.py
Supports: review, access
- Repository licence ↗Checked
https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/LICENSE
Supports: license, access.cost