home / mcp / markitdown mcp server
NPX wrapper for Microsoft's MarkItDown MCP server - run without Docker
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.
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.
Prerequisites you need to have installed on your system before starting:
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.
{
"mcpServers": {
"markitdown": {
"command": "npx",
"args": [
"-y",
"markitdown-mcp-npx"
]
}
}
}To verify the setup, run the help command and confirm the server responds as expected.
npx -y markitdown-mcp-npx --helpA 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.