---
title: "MarkItDown MCP: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/markitdown/
description: "Converts supported documents and web resources into Markdown through a local MCP tool."
---

# MarkItDown MCP: review, setup & limitations · Undominated.ai

> Converts supported documents and web resources into Markdown through a local MCP tool.

[← Explore all mcp servers](/mcp-servers/)

DOCUMENT CONVERSION / Microsoft

# MarkItDown MCP

Converts supported documents and web resources into Markdown through a local MCP tool.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/microsoft/markitdown/tree/main/packages/markitdown-mcp)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 6 linked sources
 Publisher Microsoft
 Licence [MIT ↗](https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/LICENSE)
 Revision 4cc9fa17653d
 [Read what was—and wasn’t—checked ↓](#review)

“An MCP server for the "markitdown" library.”

 [Microsoft · upstream description ↗](https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/packages/markitdown-mcp/pyproject.toml) Our analysis follows below.

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.

### A good fit for

 - Extracting text and document structure from trusted local material for an assistant.
- Converting a supported URL or office document into Markdown for further analysis.

### Weigh up before choosing

 - The URI tool reads files and fetches network resources with the process owner’s privileges; it is not a path-restricted document sandbox.
- HTTP mode has no authentication and is intended for trusted local use. Keep its loopback binding unless you supply appropriate external controls.
- Conversion preserves useful text structure, but is not a high-fidelity document-layout or OCR guarantee.

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.

[Upstream setup instructions ↗](https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/packages/markitdown-mcp/README.md)

DOCUMENTED COMMAND

 pip install markitdown-mcp Copy command ↗

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"
 ]
 }
 }
} Copy configuration ↗

### Compatibility

Local MCP clients using stdio. · Local clients supporting the documented Streamable HTTP or SSE endpoints.

### Implementation

Python

### Transports

stdio · Streamable HTTP · SSE

### Local file and URL conversion

 - Reads accessible local files and follows supported network URLs supplied to the conversion tool.
- Returns extracted document content to the connected assistant; plugins are an explicit additional trust decision.

### Cost model

The local package is MIT licensed; it uses your computing resources and any separately enabled conversion services.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [MCP installation and local-use guidance ↗](https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/packages/markitdown-mcp/README.md) Checked 2026-10-13 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 ↗](https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/packages/markitdown-mcp/pyproject.toml) Checked 2026-10-13 https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/packages/markitdown-mcp/pyproject.toml Supports: upstreamDescription, descriptionSourceUrl, language, install.prerequisites, review
- [MCP tool and transport implementation ↗](https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/packages/markitdown-mcp/src/markitdown_mcp/__main__.py) Checked 2026-10-13 https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/packages/markitdown-mcp/src/markitdown_mcp/__main__.py Supports: review, transports, access, limitations
- [Converter scope and security considerations ↗](https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/README.md) Checked 2026-10-13 https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/README.md Supports: summary, bestFor, whySelected, limitations, access
- [Resource conversion implementation ↗](https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/packages/markitdown/src/markitdown/_markitdown.py) Checked 2026-10-13 https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/packages/markitdown/src/markitdown/_markitdown.py Supports: review, access
- [Repository licence ↗](https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/LICENSE) Checked 2026-10-13 https://github.com/microsoft/markitdown/blob/4cc9fa17653d695d64fb9eee5b33d4de55ff84e8/LICENSE Supports: license, access.cost

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Fetch MCP reference server ↗ Retrieve a URL as text or Markdown in chunks through a small local MCP server.](/mcp-servers/fetch/)[### Meilisearch MCP ↗ Search and administer Meilisearch indexes, documents, settings and API keys from a local MCP process.](/mcp-servers/meilisearch/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
