Skip to content
MCP server

markitai

Convert documents, images and web pages to Markdown from any MCP client

Runs locallyStatus and history
Install
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 markitai

Add to claude_desktop_config.json

{
  "mcpServers": {
    "markitai": {
      "command": "uvx",
      "args": [
        "markitai"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "markitai": {
      "command": "uvx",
      "args": [
        "markitai"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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 set
  • MARKITAI_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

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media