# markitai

> markitai is an open-source MCP server for files and documents. Convert documents, images and web pages to Markdown from any MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://markitai.dev/guide/mcp
- **Repository:** https://github.com/ynewtime/markitai
- **MCP Registry name:** io.github.Ynewtime/markitai
- **Categories:** files and documents
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add markitai -- uvx markitai
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "markitai": {
      "command": "uvx",
      "args": [
        "markitai"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "markitai": {
      "command": "uvx",
      "args": [
        "markitai"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "markitai": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "markitai"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "markitai": {
      "command": "uvx",
      "args": [
        "markitai"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "markitai": {
      "command": "uvx",
      "args": [
        "markitai"
      ]
    }
  }
}
```

## Tools

- `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.

## 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

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/markitai
