markitdown_mcp_ MCP Server

Use This MCP server To

Convert PDFs to Markdown for easy content parsing Transform PowerPoint slides into Markdown notes Extract Word document content as Markdown Convert Excel sheets into Markdown tables Extract and transcribe audio files to Markdown text Perform OCR on images and convert to Markdown Parse HTML files into Markdown format Iterate and convert ZIP file contents to Markdown Convert CSV, JSON, and XML files into Markdown Extract EXIF metadata from images and audio

README

MarkItDown MCP Server

A Model Context Protocol (MCP) server that converts various file formats to Markdown using the MarkItDown utility.

Supported Formats

PDF
PowerPoint
Word
Excel
Images (EXIF metadata and OCR)
Audio (EXIF metadata and speech transcription)
HTML
Text-based formats (CSV, JSON, XML)
ZIP files (iterates over contents)

Installation

Installing via Smithery

To install MarkItDown MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @KorigamiK/markitdown_mcp_server --client claude

Manual Installation

Clone this repository
Install dependencies:

uv install

Usage

As MCP Server

The server can be integrated with any MCP client. Here are some examples:

Zed Editor

Add the following to your settings.json:

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

Commands

The server responds to the following MCP commands:

/md <file> - Convert the specified file to Markdown

Example:

/md document.pdf

Supported MCP Clients

Works with any MCP-compliant client listed at modelcontextprotocol.io/clients, including:

Zed Editor
Any other MCP-compatible editors and tools

License

MIT License. See LICENSE for details.

Acknowledgements

https://github.com/microsoft/markitdown#readme

markitdown_mcp_server FAQ

How do I install the MarkItDown MCP Server?

You can install it automatically via Smithery CLI or manually by cloning the repository and following setup instructions.

What file formats does MarkItDown support?

It supports PDF, PowerPoint, Word, Excel, images, audio, HTML, CSV, JSON, XML, and ZIP files.

Does MarkItDown support OCR and speech transcription?

Yes, it performs OCR on images and speech transcription on audio files to convert content into Markdown.

Can MarkItDown extract metadata from files?

Yes, it extracts EXIF metadata from images and audio files.

How does MarkItDown handle ZIP files?

It iterates over the contents of ZIP files and converts each supported file inside to Markdown.

Is MarkItDown compatible with multiple LLM providers?

Yes, it works with models like OpenAI GPT, Anthropic Claude, and Google Gemini via MCP.

Can I use MarkItDown to convert complex documents with mixed content?

Yes, it supports a variety of formats and extracts text, metadata, and transcriptions for comprehensive Markdown output.

What is the benefit of converting files to Markdown for LLMs?

Markdown provides a clean, structured, and readable format that improves LLM context understanding and processing.