MarkItDown MCP Server for Zed

[!WARNING]
Python 3.14+ / Arch-based Users: If you encounter installation timeouts or onnxruntime dependency conflicts, please read the 🛠️ Python 3.14+ Quick Fix section below before installation.

This extension integrates MarkItDown as a Model Context Protocol (MCP) Server for for Zed's Assistant.

for upstream information, check MarkItDown-MCP

What This Extension Does

Turn any Documents into AI Context - Upload or reference any file, and this extension converts it to clean Markdown that AI can understand and work with without Multimodality.

Supported File Types

It exposes one tool: convert_to_markdown(uri), where uri can be any http:, https:, file:, or data: URI.

Quick Start

Installation (dev)

# Clone the repo
git clone [https://github.com/G36maid/zed-mcp-server-markitdown.git](https://github.com/G36maid/zed-mcp-server-markitdown.git)
cd zed-mcp-server-markitdown

# Build the extension
cargo build --release

# Add as a dev extension in Zed:
# In Zed, go to Extensions → Install Dev Extension → Select this directory

Usage Examples

Convert a PDF report:

Please analyze this PDF report and summarize the key findings.

Extract data from a spreadsheet:

Convert this Excel file to markdown and show me the top 5 entries.

Analyze a webpage:

Summarize the main points from this article form link in README.

Configuration

Optional Settings

Access through Zed's settings or the Assistant configuration UI:

{
  "context_servers": {
    "mcp-server-markitdown": {
      "settings": {
        "package_version": "latest"
      }
    }
  }
}

• package_version: Specify npm package version (default: "latest")

Prerequisites

• Node.js and npm (automatically handled by Zed)
• Rust (automatically handled by Zed)
• Internet connection (for initial package installation and web calls)

Local Development

# Clone the repo
git clone [https://github.com/G36maid/zed-mcp-server-markitdown.git](https://github.com/G36maid/zed-mcp-server-markitdown.git)
cd zed-mcp-server-markitdown

# Build the extension
cargo build --release

# Add as a dev extension in Zed:
# In Zed, go to Extensions → Install Dev Extension → Select this directory

🛠️ Python 3.14+ Quick Fix

If you encounter installation timeouts or dependency conflicts on Arch Linux or other systems that have updated to Python 3.14, it's recommended to configure uvx directly in Zed's settings.json. This uses an isolated Python 3.13 environment, bypassing upstream compatibility issues.

1. Prerequisites

Ensure uv is installed on your system.

2. Configure Zed

Open settings.json in Zed (Command Palette: type settings) and add the following configuration:

{
  "context_servers": {
    "markitdown": {
      "command": "uvx",
      "args": [
        "--python",
        "3.13",
        "markitdown-mcp"
      ]
    }
  }
}

3. Warm Up the Environment (Important)

Since the first startup downloads Python 3.13 and related AI models (like Magika), it may exceed Zed's 60-second startup limit. Run it once

... View full README on GitHub