English Français العربية

markitai

Official registry Search and web

Convert documents, images and web pages to clean Markdown, for agents: single, URL and batch tools.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package markitai
Claude Code 
claude mcp add markitai -e 'MODEL=<MODEL>' -e 'MARKITAI_HOME=<MARKITAI_HOME>' -- uvx markitai==2.3.1 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "markitai": {
            "command": "uvx",
            "args": [
                "markitai==2.3.1",
                "mcp"
            ],
            "env": {
                "MODEL": "<MODEL>",
                "MARKITAI_HOME": "<MARKITAI_HOME>"
            }
        }
    }
}

Environment variables

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Markitai
  2. Install
  3. Quick start
  4. Documentation
  5. License

Markitai

Markitai converts documents, web pages and images to Markdown. A single Rust core powers the markitai command (alias mkai), a local REST service with a browser workspace, an MCP server, and in-process Node.js, Python and Go bindings. The CLI executable needs no Python, Node.js or Go runtime; language bindings need their respective language runtime.

Markitai 2.0 is the Rust rewrite of Python markitai 1.2. See the changelog and compatibility contracts.

Install

macOS and Linux:

curl -fsSL https://markitai.dev/setup.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://markitai.dev/setup.ps1 | iex"

The setup scripts download the release archive for your machine from GitHub Releases, check it against the release's SHA256SUMS, and install markitai, mkai and markitai-mcp for the current user, without administrator rights. Releases cover macOS 11+ (Apple silicon, Intel), Linux with glibc 2.28+ (x86-64, ARM64) and Windows (x64, ARM64). Python users can instead run pip install markitai or uv tool install markitai: PyPI has wheels for the same six platforms (Python 3.10+); elsewhere pip keeps markitai 1.x. Manual downloads, updates and uninstalling are in the installation steps.

The archives include license notices and selected Markdown guides for offline use. OCR models, Chromium and LibreOffice are optional separate components. See platform support for requirements, unsigned macOS builds for Gatekeeper, and bindings for language packages.

Quick start

markitai report.docx -o out/                  # writes out/report.docx.md
markitai ./documents -o out/                  # whole folder, with a report
markitai scan.png --ocr -o out/               # local OCR; models may need preparation
markitai report.docx -o out/ --json           # structured result for automation
markitai doctor                              # inspect optional components
markitai --help                              # commands, options and examples
markitai serve                               # browser workspace on 127.0.0.1:3600

For a separate trial state, set MARKITAI_HOME before using the CLI: export MARKITAI_HOME="$PWD/.local/try-home". Plain document conversion does not need a model connection. Existing configuration still applies; use --no-llm -b native for local document processing without model enhancement. URL inputs still need the network, even with --no-remote-fetch. Local OCR uses the portable Paddle engine on every platform (macOS Vision with MARKITAI_OCR_BACKEND=vision); doctor --fix can prepare missing Paddle models before offline use. JavaScript pages need Chrome/Chromium; Office page images need LibreOffice. Model enhancement (--llm) uses configured provider credentials or a subscription runtime.

Documentation

  • Quick start: installation and the first ten tasks.
  • CLI and MCP: command and Agent contracts.
  • Agent index and standalone Agent guide: plain Markdown entry points, also included in CLI archives.
  • Documentation index: the full source-checkout documentation. The offline archive contains selected guides; other topic links require this repository checkout.

License

MIT; see LICENSE and NOTICE.

Frequently asked questions

What is markitai?

Convert documents, images and web pages to clean Markdown, for agents: single, URL and batch tools.

How do I install markitai?

It runs on your machine. In Claude Code: claude mcp add markitai -e 'MODEL=<MODEL>' -e 'MARKITAI_HOME=<MARKITAI_HOME>' -- uvx markitai==2.3.1 mcp. For other clients, paste the JSON configuration from this page into their MCP settings.

Does markitai need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is markitai open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains markitai?

It is published by Ynewtime. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.