MarkItDown-MCP-NPX
About
NPX wrapper for Microsoft's MarkItDown MCP server - run without Docker
Details
- Author
- xkiranj
- GitHub stars
- 14
- Downloads
- 290
- Categories
- Other
Jump to
- 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
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
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.
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"
]
}
}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.
