mcpField
M
MarkItDown MCP Server

MarkItDown MCP Server

Local
github.com/KorigamiKProductivity88Updated 44w ago
Repository

About MarkItDown MCP Server

MarkItDown MCP Server is an MCP server that converts many file types to Markdown using the MarkItDown utility. It is aimed at users who want to pass document contents to AI models in a text form.

Key features

  1. 01Converts PDF, Word, PowerPoint and Excel files
  2. 02OCR for images and speech transcription for audio
  3. 03Handles HTML and text formats such as CSV, JSON and XML
  4. 04Iterates over the contents of ZIP files

Use cases

  1. 01Turning PDF or Office documents into Markdown for a model to read
  2. 02Converting files from the Zed editor with the /md command

MCP support

This is an MCP server that provides a /md command to MCP clients, which converts a specified file to Markdown.

#python#mcp#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "markitdown_mcp_server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MarkItDown MCP Server

smithery badge

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

MarkItDown Server MCP server

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
  1. Clone this repository
  2. 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-mcp"
      ]
    }
  }
}
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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.