Skip to main content

Add your description here

Project description

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"
      ]
    }
  }
}

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_markitdown_mcp_server-0.1.0.tar.gz (26.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_markitdown_mcp_server-0.1.0.tar.gz.

File metadata

File hashes

Hashes for iflow_mcp_markitdown_mcp_server-0.1.0.tar.gz
Algorithm Hash digest
SHA256 a782e809a4cfcc7368875b5f9183780e6aab1546242492d3ee123708163f8af8
MD5 96d25df2bfab9de915048f1089e6c9e6
BLAKE2b-256 9fc5d1a7b44671a2b1a873fe0af0d284d3748fff5f6ee2d6382cb4d73a505102

See more details on using hashes here.

File details

Details for the file iflow_mcp_markitdown_mcp_server-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for iflow_mcp_markitdown_mcp_server-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a0d2282315e31617fc30424d4d3480bd667aac87f60ac1bcbd934cd66678ad4c
MD5 c11f2bea812eaeb540fc3de5cae0cde9
BLAKE2b-256 2e6bdae3a21d9a8c01e4fd6191732af058f51dd50aeef7ca292f6d18563b821d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page