markitai
Convert documents, images and web pages to Markdown from any MCP client
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 2.3.2
- Listing updated
- 2 days ago
About markitai
markitai is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
The server shares its conversion pipeline with the markitai command line, so results match what you get from the CLI. A Rust core does the work, and the stdio server ships in every install as markitai-mcp, or can be started with markitai mcp or fetched on demand through uvx.
Four tools cover the workflow: one for a local file, one for a web page or a PDF served by a URL, a batch tool that runs in the background and returns a job id, and a status tool for that job. Results return the Markdown, written file paths, cost, duration and warnings. Output past 40,000 characters comes back as a 2,000-character preview with the full text saved to a file.
Optional extras are off by default: LLM enhancement needs a configured model and may incur provider charges, OCR downloads its models on first use, and JavaScript pages or URL screenshots need Chrome or Chromium. Warnings flag things like scanned-looking pages or hidden PDF text that could be a prompt injection.
Install
Run in a terminal
claude mcp add markitai -- uvx markitaiAdd to claude_desktop_config.json
{
"mcpServers": {
"markitai": {
"command": "uvx",
"args": [
"markitai"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"markitai": {
"command": "uvx",
"args": [
"markitai"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"markitai": {
"type": "stdio",
"command": "uvx",
"args": [
"markitai"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"markitai": {
"command": "uvx",
"args": [
"markitai"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"markitai": {
"command": "uvx",
"args": [
"markitai"
]
}
}
}Configuration
MODELprovider/model for --llm enhancement, e.g. gemini/gemini-flash-lite-latest; with the matching API key env var setMARKITAI_HOMEMarkitai's configuration, cache and model directory (default ~/.markitai)
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- convert_document
- Converts one local file to Markdown.
- convert_url
- Converts a web page's main content, or a PDF served by a URL.
- batch_convert
- Converts many paths or URLs in the background and returns a job_id.
- job_status
- Reports progress and per-item results of a batch job.
What it does
- Single-file conversion
- Converts one local document by absolute path to Markdown.
- URL and PDF conversion
- Pulls the main content of a web page, or a PDF a URL serves.
- Background batch jobs
- Runs up to 10,000 sources per job and reports progress by job id.
- Output profiles
- Offers rag, obsidian and okf profiles for the written output.
- Optional OCR and LLM pass
- Adds OCR or model enhancement when requested, with cost reported per call.
- Warnings on risky input
- Flags scanned pages, hidden PDF text and failed enhancement without failing the call.
Good for
- Turn a folder of Office files into Markdown for a RAG index
- Let an agent read a web page or PDF as clean Markdown
- Convert scanned images with OCR before summarising them
- Prepare notes for an Obsidian vault in bulk
Pricing
Open source
MIT licence; model enhancement uses your own provider credentials
Prices change. Check markitai.dev before you buy.
markitai FAQ
How does it run?
Over stdio. Install it with the setup script and register the `markitai-mcp` command, or use uvx to fetch the PyPI package on demand.
Does conversion cost money?
Plain conversion needs no model. The llm option may cost provider charges, and results report cost_usd.
What happens with large output?
Past 40,000 characters you get a 2,000-character preview and the full Markdown is written to a file.
Can it handle many files at once?
Yes. batch_convert accepts up to 10,000 paths or URLs per job and returns a job_id to poll.
Is markitai free?
Yes. markitai is open source, so you can use and self-host it for free.
How do I add markitai to Claude Code?
Run this command in your terminal: claude mcp add markitai -- uvx markitai
What are the best alternatives to markitai?
The closest alternatives to markitai are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.
Alternatives to markitai

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents
Invoices
MCP serverMCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files
- 4 tools
- Remote
- Paid
- Files and documents

SigPen
MCP serverMCP server that drafts e-signature documents while you approve every send
Not checked yet- 13 tools
- Remote
- Freemium
- Files and documents

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media

WhoScribe
MCP serverSearch and read your WhoScribe audio and video transcripts from ChatGPT, read-only
Not checked yet- Remote
- Freemium
- Design and media