MarkItDown-MCP
by Microsoft
The `markitdown-mcp` package provides a lightweight STDIO and SSE MCP server for calling MarkItDown. It exposes a tool to convert various URI types to markdown.
Last updated: N/A
What is MarkItDown-MCP?
MarkItDown-MCP is a lightweight STDIO and SSE MCP (Model Context Protocol) server that allows you to convert content from various URI types (http, https, file, data) into Markdown format.
How to use MarkItDown-MCP?
To use MarkItDown-MCP, first install it using pip install markitdown-mcp
. Then, run the server using the markitdown-mcp
command. You can run it in STDIO mode (default) or SSE mode with specified host and port. The server exposes the convert_to_markdown(uri)
tool, which you can call with a valid URI to get the Markdown output.
Key features of MarkItDown-MCP
Converts URIs to Markdown
Supports STDIO and SSE
Lightweight and easy to install
Can be run in Docker
Integrates with Claude Desktop
Use cases of MarkItDown-MCP
Converting web pages to Markdown
Converting local files to Markdown
Integrating with Claude Desktop for Markdown conversion
Automated Markdown generation from various data sources
FAQ from MarkItDown-MCP
How do I install MarkItDown-MCP?
How do I install MarkItDown-MCP?
Use pip install markitdown-mcp
.
How do I run the server in STDIO mode?
How do I run the server in STDIO mode?
Run the command markitdown-mcp
.
How do I run the server in SSE mode?
How do I run the server in SSE mode?
Run the command markitdown-mcp --sse --host 127.0.0.1 --port 3001
.
How do I run MarkItDown-MCP in Docker?
How do I run MarkItDown-MCP in Docker?
Build the Docker image using docker build -t markitdown-mcp:latest .
and run it using docker run -it --rm markitdown-mcp:latest
.
How do I access local files when running in Docker?
How do I access local files when running in Docker?
Mount the local directory into the container using the -v
flag, e.g., docker run -it --rm -v /home/user/data:/workdir markitdown-mcp:latest
.