Skip to main content
Glama
alfredoanton82

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: document-converter-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

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 issues

Resources

Related MCP Connectors

Related MCP Servers

  • Local RAG

    shinpr
    A
    license
    A
    quality
    A
    maintenance
    Privacy-first local document search using semantic search. Runs entirely on your machine with no cloud services, supporting PDF, DOCX, TXT, and Markdown files.
    22
    9
    4,655 npm
    398
    MIT
  • groupdocs-markdown-mcp by groupdocs-markdown

    groupdocs-markdown-mcpofficial

    groupdocs-markdown
    A
    license
    Not graded
    quality
    A
    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