MarkItDown
About
Converts diverse file formats to Markdown using MarkItDown utility, enabling unified text-based workflows for content migration, documentation, and analysis.
Details
- Author
- korigamik
- Repository
- KorigamiK/markitdown_mcp_server
- GitHub stars
- 26
- Downloads
- 1,323
- License
- MIT License
- Categories
- Productivity, Developer Tools, Design, Workplace, File Management, Media, Infrastructure, Knowledge Base, Other
- Tags
- #integration
Jump to
- Converts PDF, PowerPoint, Word, and Excel files to Markdown
- Extracts EXIF metadata and performs OCR on images
- Transcribes speech and reads EXIF from audio files
- Handles HTML, CSV, JSON, XML, and ZIP archives
- Integrates with any MCP-compatible editor or tool
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
MarkItDownCommand (node, npx, python, etc.)uvArguments-
Argument 1
--directory -
Argument 2
/path/to/markitdown_mcp_server -
Argument 3
run -
Argument 4
markitdown-mcp
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
To install MarkItDown MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @KorigamiK/markitdown_mcp_server --client claude
1. Clone this repository
2. Install dependencies:
uv install
/md <file>
Convert the specified file to Markdown. Parameter: file (the file path to convert)
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"markitdown": {
"cwd": null,
"env": {},
"args": [
"--directory",
"/path/to/markitdown_mcp_server",
"run",
"markitdown-mcp"
],
"shell": false,
"command": "uv"
}
}
}Linux
{
"cwd": null,
"env": [],
"args": [
"--directory",
"/path/to/markitdown_mcp_server",
"run",
"markitdown-mcp"
],
"shell": false,
"command": "uv"
}Macos
{
"cwd": null,
"env": [],
"args": [
"--directory",
"/path/to/markitdown_mcp_server",
"run",
"markitdown-mcp"
],
"shell": false,
"command": "uv"
}Windows
{
"cwd": null,
"env": [],
"args": [
"--directory",
"/path/to/markitdown_mcp_server",
"run",
"markitdown-mcp"
],
"shell": false,
"command": "uv"
}MarkItDown MCP Server
A Model Context Protocol (MCP) server that converts various file formats to Markdown using the MarkItDown utility.
<a href="https://glama.ai/mcp/servers/sbc6bljjg5"></a>
Supported Formats
- PDF
- PowerPoint
- Word
- Excel
- Images (EXIF metadata and OCR)
- Audio (EXIF metadata and speech transcription)
- HTML
- Text-based formats (CSV, JSON, XML)
- ZIP files (iterates over contents)
Installation
Installing via Smithery
To install MarkItDown MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @KorigamiK/markitdown_mcp_server --client claude
Manual Installation
1. Clone this repository
2. Install dependencies:
uv install
Usage
As MCP Server
The server can be integrated with any MCP client. Here are some examples:
Zed Editor
Add the following to your settings.json:
"context_servers": {
"markitdown_mcp": {
"settings": {},
"command": {
"path": "uv",
"args": [
"--directory",
"/path/to/markitdown_mcp_server",
"run",
"markitdown-mcp"
]
}
}
}
Commands
The server responds to the following MCP commands:
- /md <file> - Convert the specified file to Markdown
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
