# markitai MCP server

> Converts documents, images, and web pages into clean Markdown for AI agents using single, URL, or batch processing.

- Repository: https://github.com/Ynewtime/markitai
- Page: https://hostedmcp.org/servers/ynewtime/markitai
- Transport: stdio
- Stars: 2
- License: MIT
- Latest version: 2.3.2

## Install

### Claude Code

```sh
claude mcp add markitai -- uvx 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"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"markitai","type":"stdio","command":"uvx","args":["markitai"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

```sh
codex mcp add markitai -- uvx markitai
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.markitai]
command = "uvx"
args = ["markitai"]
```

### Gemini CLI

```sh
gemini mcp add -s user markitai uvx -- markitai
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `MARKITAI_HOME` | no | no | Markitai's configuration, cache and model directory (default ~/.markitai) |
| `MODEL` | no | no | provider/model for --llm enhancement, e.g. gemini/gemini-flash-lite-latest; with the matching API key env var set |

## FAQ

### What can Markitai convert?

It converts documents, web pages, and images into Markdown format.

### Does the CLI require Python or Node.js to run?

No, the CLI executable does not require a Python, Node.js, or Go runtime, though language bindings do require their respective runtimes.

### Can I use Markitai for local document processing without an LLM?

Yes, you can use the --no-llm -b native flag for local processing without model enhancement.

### What is needed to process JavaScript web pages?

Processing JavaScript pages requires Chrome or Chromium.
