MCP.so
Sign In

MarkItDown-MCP-NPX

@xkiranj

Repository

About MarkItDown-MCP-NPX

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

Basic information

Category

Other

License

NOASSERTION

Runtime

node

Transports

stdio

Publisher

xkiranj

Config

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

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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

FAQ from MarkItDown-MCP-NPX

Does this require Docker?

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

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.

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.

What transport modes are supported?

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

Is there authentication for HTTP mode?

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

Comments

More Other MCP servers

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

ACI: Open-Source Infra to Power Unified MCP Servers

aipotheosis-labs

ACI.dev is the open source tool-calling platform that hooks up 600+ tools into any agentic IDE or custom AI agent through direct function calling or a unified MCP server. The birthplace of VibeOps.

4.8K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K