Skip to main content
Glama
alfredoanton82

markitdown-mcp

by alfredoanton82
OverviewSchemaRelated ServersScoreDiscussions
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: Local RAG

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 installed

F
license - not found
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • MarkItDown MCP

    xkiranj
    A
    license
    Not graded
    quality
    D
    maintenance
    Converts various file types (documents, images, audio, web content) to markdown format without requiring Docker, supporting PDF, Word, Excel, PowerPoint, images, audio files, web URLs, and more.
    296
    14
    MIT

  • 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.
    9
    3,271
    365
    MIT

  • rag-mcp

    Kamalesh-Kavin
    F
    license
    A
    quality
    D
    maintenance
    Enables indexing local documents (PDF, Markdown, text, code) into a knowledge base and querying them via semantic search using local embeddings, all running privately on your machine.
    4

View all related MCP servers

Related MCP Connectors

  • second-brain-bridge

    Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.

  • netcafe-docflow

    Markdown in, any format out. PDFs merged, split, watermarked. Runs on our own doc engines.

  • Unmarkdown

    The document publishing layer for AI tools. Convert markdown to 6 destinations, 62 templates.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/alfredoanton82/markitdown-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server