MarkItDown-MCP logo

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.

View on GitHub

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?

Use pip install markitdown-mcp.

How do I run the server in STDIO mode?

Run the command markitdown-mcp.

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?

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?

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.