Advertise
MCP.so
Sign In

MarkItDown MCP NPX

@xkiranj

Repository

Basic information

Category

Other

License

NOASSERTION

Transports

stdio

Author

xkiranj

About MarkItDown MCP NPX

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

MarkItDown MCP NPX config

Add this server to your MCP-compatible client using the configuration below.

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

MarkItDown MCP NPX tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is MarkItDown-MCP-NPX?

An NPX wrapper for Microsoft's MarkItDown MCP server that converts files (PDF, Word, Excel, images, audio, URLs, archives, CSV, JSON, XML) to Markdown format without requiring Docker.

How to use MarkItDown-MCP-NPX?

Run directly with npx -y markitdown-mcp-npx (recommended) or install globally with npm install -g markitdown-mcp-npx then run markitdown-mcp-npx. Configure for Claude Desktop by adding the command to the mcpServers JSON. Use --http, --host, --port flags for HTTP/SSE mode.

Key features of MarkItDown-MCP-NPX

  • No Docker required; runs directly via NPX
  • Zero configuration – just run npx -y markitdown-mcp-npx
  • Cross-platform: Windows, macOS, Linux
  • Automatically manages Python virtual environment and dependencies
  • Single convert_to_markdown tool handles all supported file types
  • Reuses virtual environment for faster subsequent runs

Use cases of MarkItDown-MCP-NPX

  • Convert documents (PDF, DOCX, PPTX, XLSX) to Markdown for LLM ingestion
  • Extract text from images using OCR
  • Transcribe audio files (MP3, WAV) when FFmpeg is installed
  • Process web URLs and archives (ZIP) into Markdown
  • Integrate with Claude Desktop as an MCP server for file conversion

Frequently asked questions

1

Does this require Docker?

No. MarkItDown-MCP-NPX is designed to run without Docker; it only needs Node.js 16+ and Python 3.10+.

2

What are the prerequisites?

Node.js 16+, Python 3.10+, and an internet connection for initial package download. FFmpeg and ExifTool are optional for audio and advanced image metadata.

3

How do I fix a hanging server on startup?

Use the `-y` flag with NPX (`npx -y markitdown-mcp-npx`) to skip installation prompts that can hang in non-interactive environments like Claude Desktop.

4

What transport modes are supported?

STDIO (default) and HTTP/SSE. Use `--http --host <host> --port <port>` for HTTP mode.

5

Is there authentication for HTTP mode?

No authentication is provided; the README recommends binding to `localhost` unless otherwise needed.

Comments

More Other MCP servers

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K
Advertise