MarkItDown

Converts PDFs, Office files, images, audio, HTML, text, and more into Markdown using the MarkItDown utility.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-korigamik_markitdown_mcp_server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/markitdown_mcp_server",
        "run",
        "markitdown"
      ]
    }
  }
}

MarkItDown MCP Server is a dedicated engine that converts a wide range of file formats into Markdown, enabling you to transform documents, slides, spreadsheets, images, audio, HTML, and more into clean, readable Markdown for easy editing and publishing.

How to use

You connect MarkItDown as an MCP server to your MCP client, then send files you want converted to Markdown. The server supports many input types and handles the conversion automatically, so you can batch convert documents, slides, spreadsheets, images with embedded text, audio with transcripts, and other text-based formats.

How to install

Prerequisites: you need Node.js and npm installed, and you should have access to the uv tool for running MCP servers.

# Install via Smithery for Claude Desktop
npx -y @smithery/cli install @KorigamiK/markitdown_mcp_server --client claude

# Manual installation
# 1. Clone the repository
# 2. Install dependencies
uv install

Additional notes

To run MarkItDown in MCP setups, you typically configure it as a stdio server using the uv launcher. A common local setup passes the server path and command to uv so the MCP client can start the process and communicate with it.

"context_servers": {
  "markitdown_mcp": {
    "settings": {},
    "command": {
      "path": "uv",
      "args": [
        "--directory",
        "/path/to/markitdown_mcp_server",
        "run",
        "markitdown"
      ]
    }
  }
}

Usage examples and commands

Convert a specific file to Markdown using the MCP command you configure in your client. The typical command would be issuing a request like converting a file you provide to Markdown, which then returns the Markdown content.

/md document.pdf

Available tools

markitdown_convert

Converts input documents of various formats (PDF, Word, PowerPoint, Excel, images, HTML, text-based formats, and more) into Markdown using the MarkItDown utility.