@KorigamiK/markitdown_mcp_serverPublic

MCP server for MarkItDown file to Markdown conversion

This is an MCP server that wraps MarkItDown so clients can convert common file formats into Markdown. It is meant to be added to an MCP-capable editor or tool, then called with the `/md` command on a file.

87 stars•16 forks•Python•Updated 9mo ago

Who it's for

Builders who use MCP clients and want files converted to Markdown inside their workflow.

What it delivers

You can turn PDFs, Office files, images, audio, and archives into Markdown without leaving your MCP client.

What it does

File to Markdown conversion

Adds a `/md <file>` MCP command that converts a chosen file into Markdown.

Broad format support

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

MCP client integration

Works with any MCP-compliant client, including Zed and Claude via Smithery.

Markdown extraction from media

Uses MarkItDown features like EXIF metadata, OCR, and speech transcription for images and audio.

How to get it

1To install MarkItDown MCP Server for Claude Desktop automatically via Smithery
```
npx -y @smithery/cli install @KorigamiK/markitdown_mcp_server --client claude
```
2Install dependencies
```
uv install
```
3Example
```
/md document.pdf
```

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-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

Files in the repo

Repository payload•9 top-level entries

src— Source code
.gitignore
.python-version
Dockerfile— Container build for running the server.
LICENSE— License
pyproject.toml— Project metadata and dependency setup.
README.md— The README
smithery.yaml— Smithery installation configuration.
uv.lock— Locked dependency versions for the Python environment.

Discussion (0)

Ask about usage, or say what you built with it

No comments yet. Be the first to say what this is good for.

More connectors

koala73/worldmonitorConnectors

Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface

86k

okf-memory/

okf-agent-memory

okf-memory/okf-agent-memoryConnectors

Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.

547

t8y2/dbxConnectors

20 MB lightweight cross-platform database client for 90+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具，支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 90+ 数据库，提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。

19k

citrolabs/ego-liteConnectors

The fastest browser for AI agents to run browser automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config.

16k

upstash/context7Connectors

Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

62k

1 add

noskillish/

bankmcp

noskillish/bankmcpConnectors

BankMCP™: your AI can now read your bank. Self-hosted, read-only MCP server for your own bank accounts via open banking (Enable Banking). Standard MCP; tested with Claude and Ollama.

177