MarkItDown-MCP-NPX
About
NPX wrapper for Microsoft's MarkItDown MCP server - run without Docker
Explore
- 🚀 No Docker Required: Run directly with NPX - no installation needed
- 🔧 Automatic Setup: Handles Python environment and dependencies automatically
- 🔄 Full Compatibility: Works exactly like the original Docker version
- 💻 Cross-Platform: Works on Windows, macOS, and Linux
- ⚡ Fast: Reuses virtual environment after first setup
- 📦 Zero Config: Just run npx -y markitdown-mcp-npx and you're ready!
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MarkItDown-MCP-NPXCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
npm install -g markitdown-mcp-npx
NPX Version (Recommended):
{
"mcpServers": {
"markitdown": {
"command": "npx",
"args": [
"-y",
"markitdown-mcp-npx"
]
}
}
}
With HTTP transport:
{
"mcpServers": {
"markitdown": {
"command": "npx",
"args": [
"-y",
"markitdown-mcp-npx",
"--http",
"--host",
"127.0.0.1",
"--port",
"3001"
]
}
}
}
Global Installation:
{
"mcpServers": {
"markitdown": {
"command": "markitdown-mcp-npx",
"args": []
}
}
}
> 🔑 Critical: The -y flag is required for NPX in Claude Desktop to prevent installation prompts that would cause the server to hang.
npx -y markitdown-mcp-npx --help
Error: Failed to install markitdown-mcp
✓ Single Tool: MarkItDown MCP provides exactly 1 tool called convert_to_markdown
✓ Universal Converter: This one tool handles all file types:
- 📄 Documents: PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx)
- 🖼️ Images: JPG, PNG, GIF, etc. (with OCR support)
- 🎧 Audio: MP3, WAV (with transcription if FFmpeg installed)
- 🌐 Web: HTTP/HTTPS URLs
- 🗃️ Archives: ZIP files
- 📊 Data: CSV, JSON, XML
✓ URI Parameter: Accepts http:, https:, file:, or data: URIs
> 💡 Note: Seeing "1 tools available" in Claude Desktop is correct behavior!
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"markitdown-mcp-npx": {
"markitdown-mcp-npx": {
"command": "npx",
"args": [
"-y",
"markitdown-mcp-npx"
]
}
}
}
}McpServers
{
"markitdown-mcp-npx": {
"command": "npx",
"args": [
"-y",
"markitdown-mcp-npx"
]
}
}
NPX wrapper for Microsoft's MarkItDown MCP server - No Docker Required!
This package provides an NPX-compatible wrapper for Microsoft's markitdown-mcp, allowing you to run the MarkItDown MCP server without Docker dependencies.
✨ Features
- 🚀 No Docker Required: Run directly with NPX - no installation needed
- 🔧 Automatic Setup: Handles Python environment and dependencies automatically
- 🔄 Full Compatibility: Works exactly like the original Docker version
- 💻 Cross-Platform: Works on Windows, macOS, and Linux
- ⚡ Fast: Reuses virtual environment after first setup
- 📦 Zero Config: Just run npx -y markitdown-mcp-npx and you're ready!
📋 Prerequisites
Required
- Node.js 16+: Required for NPX execution - Python 3.10+: Required for MarkItDown functionality - Internet Connection: For initial package installationOptional (for enhanced functionality)
- FFmpeg: For audio file processing and transcription (.mp3, .wav files) - ExifTool: For advanced image metadata extraction> 💡 Note: MarkItDown works perfectly for most file types (PDF, Word, Excel, basic images) without the optional dependencies. They're only needed for audio files and advanced image metadata.
Windows users: See WINDOWS_SETUP.md for easy installation of optional dependencies.
🚀 Quick Start
Using NPX (Recommended - No Installation Required!)
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
