markitdown-mcp

# MarkItDown-MCP > [!IMPORTANT] > The MarkItDown-MCP package is meant for **local use**, with local trusted agents. In particular, when running the MCP server with Streamable HTTP or SSE, it binds to `localhost` by default, and is not exposed to other machines on the network or Internet. In this configuration, it is meant to be a direct alternative to the STDIO transport, which may be more convenient in some cases. DO NOT bind the server to other interfaces unless you understand the [security implications](#security-considerations) of doing so. [](https://pypi.org/project/markitdown-mcp/)  [](https://github.com/microsoft/autogen) The `markitdown-mcp` package provides a lightweight STDIO, Streamable HTTP, and SSE MCP server for calling MarkItDown. It exposes one tool: `convert_to_markdown(uri)`, where uri can be any `http:`, `https:`, `file:`, or `data:` URI. ## Installation To install the package, use pip: ```bash pip install markitdown-mcp ``` ## Usage To run the MCP server, using STDIO (default), use the following command: ```bash markitdown-mcp ``` To run the MCP server, using Streamable HTTP and SSE, use the following command: ```bash markitdown-mcp --http --host 127.0.0.1 --port 3001 ``` ## Running in Docker To run `markitdown-mcp` in Docker, build the Docker image using the provided Dockerfile: ```bash docker build -t markitdown-mcp:latest . ``` And run it using: ```bash docker run -it --rm markitdown-mcp:latest ``` This will be sufficient for remote URIs. To access local files, you need to mount the local directory into the container. For example, if you want to access files in `/home/user/data`, you can run: ```bash docker run -it --rm -v /home/user/data:/workdir markitdown-mcp:latest ``` Once mounted, all files under data will be acces…