MarkItDown

NPX wrapper for Microsoft's MarkItDown MCP server - run without Docker

javascript

11

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "xkiranj-markitdown-mcp-npx": {
      "command": "npx",
      "args": [
        "-y",
        "markitdown-mcp-npx"
      ]
    }
  }
}

MarkItDown MCP Server is a lightweight NPX-wrapped MCP server that lets you run the MarkItDown MCP workflow without Docker. It automates the Python environment setup and dependencies, enabling quick, cross‑platform access to MarkItDown’s conversion capabilities from any MCP client.

How to use

You interact with the MarkItDown MCP Server from your MCP client. Use the standard MCP transport you prefer (STDIO for local use or HTTP/Streamable HTTP for remote access) and point your client at the server’s address and port. This wrapper provides a single tool called convert_to_markdown that handles a wide range of file types by converting inputs to Markdown.

How to install

Prerequisites you need to have installed on your system before starting:

Node.js 16+
Python 3.10+
Internet connection for initial setup

Configuration and usage notes

The wrapper is designed to be used directly with NPX. If you want to run it without any local installation, use NPX with the recommended flag to avoid prompts. You can also configure a Claude Desktop setup to point at the NPX invocation.

If you prefer HTTP transport for testing, you can enable the HTTP/Port options when starting, but ensure you run the server with the appropriate NPX command and flags. The base STDIO mode remains the simplest path for local development.

Typical startup through NPX in STDIO mode: npx -y markitdown-mcp-npx within any terminal.

Claude Desktop configuration (examples)

{
  "mcpServers": {
    "markitdown": {
      "command": "npx",
      "args": [
        "-y",
        "markitdown-mcp-npx"
      ]
    }
  }
}

One-time verification

To verify the setup, run the help command and confirm the server responds as expected.

npx -y markitdown-mcp-npx --help

Available tools

convert_to_markdown

A universal converter tool that handles documents (PDF, Word, Excel, PPTX), images, audio (with transcription when FFmpeg is available), web URLs, archives, and data formats like CSV, JSON, and XML.