Skip to main content
Glama
Sign In
markitdown-mcp

markitdown-mcp

by alfredoanton82
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

markitdown-mcp

MCP server that converts documents to Markdown. Stateless — no database, no storage.

Tool

process_document

Converts a local file to Markdown and returns the content directly.

Input

Parameter

Type

Required

Description

file_path

string

yes

Absolute path to the file

Output

{
  "filename": "report.pdf",
  "markdown": "# Report\n...",
  "markdown_size_bytes": 4821
}

Supported formats: PDF, DOCX, XLSX, PPTX, HTML, TXT, MD

Related MCP server: groupdocs-markdown-mcp

Installation

1. Clone the repository

git clone https://github.com/alfredoanton82/markitdown-mcp.git ~/.claude/skills/markitdown-mcp
cd ~/.claude/skills/markitdown-mcp

2. Create the virtual environment and install dependencies

bash setup.sh

Add to Claude Code

Add this block to ~/.claude/.mcp.json:

{
  "mcpServers": {
    "markitdown": {
      "command": "/Users/<your-user>/.claude/skills/markitdown-mcp/venv/bin/python",
      "args": ["/Users/<your-user>/.claude/skills/markitdown-mcp/mcp_server.py"],
      "type": "stdio"
    }
  }
}

Windows paths:

{
  "mcpServers": {
    "markitdown": {
      "command": "C:\\Users\\<your-user>\\.claude\\skills\\markitdown-mcp\\venv\\Scripts\\python.exe",
      "args": ["C:\\Users\\<your-user>\\.claude\\skills\\markitdown-mcp\\mcp_server.py"],
      "type": "stdio"
    }
  }
}

Add to Claude Desktop

Edit the Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "markitdown": {
      "command": "/Users/<your-user>/.claude/skills/markitdown-mcp/venv/bin/python",
      "args": ["/Users/<your-user>/.claude/skills/markitdown-mcp/mcp_server.py"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "markitdown": {
      "command": "C:\\Users\\<your-user>\\.claude\\skills\\markitdown-mcp\\venv\\Scripts\\python.exe",
      "args": ["C:\\Users\\<your-user>\\.claude\\skills\\markitdown-mcp\\mcp_server.py"]
    }
  }
}

Restart Claude Desktop after editing the config.

Requirements

  • Python 3.10+

  • No API keys or credentials needed

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • groupdocs-markdown-mcp

      groupdocs-markdown-mcpofficial

      groupdocs-markdown
      A
      license
      Not graded
      quality
      B
      maintenance
      Converts documents (PDF, DOCX, XLSX, EPUB, etc.) to clean, structured Markdown, and retrieves document info, for use with AI agents.
      MIT

    • document-converter

      Zahid-Abbas-Ali-Baig
      A
      license
      Not graded
      quality
      C
      maintenance
      Converts PDFs, Office files, spreadsheets, emails, audio, and more to Markdown locally, enabling AI assistants to read and process them without cloud upload.
      MIT

    • document-index-mcp

      ekelly95
      A
      license
      A
      quality
      B
      maintenance
      Indexes local documents (PDF, Word, Markdown, text) into a SQLite database for AI agents to search and retrieve bounded, source-located passages. Runs fully locally with optional OCR, preserving privacy.
      5
      MIT