Converts documents, images, and web pages into clean Markdown for AI agents using single, URL, or batch processing.
Also known as Ynewtime/markitai
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- 1,894
- Latest version
- 2.3.2
- Last commit
- Nov 14, 2026
- License
- MIT
What is markitai MCP?
markitai converts documents, images, and web pages into clean Markdown for AI agents using single, URL, or batch processing.
Summary generated from the project's README
About markitai MCP server
Markitai provides a way to transform documents, images, and web pages into clean Markdown format for use with AI agents. It operates through a Rust-based core that supports a command line interface, a local REST service with a browser workspace, and an MCP server. Developers can interact with it via the markitai or mkai commands, or by using language bindings for Node.js, Python, and Go.
Users can process single files, specific URLs, or entire folders in batches. The tool handles local document conversion without needing a model connection, though it can use model enhancement via the --llm flag if provider credentials are configured. For specialized tasks, it supports local OCR using the Paddle engine or macOS Vision, and requires Chromium for JavaScript pages or LibreOffice for Office page images. The system is designed to run locally on macOS, Linux, and Windows without requiring administrator rights during installation.
What you can do with it
- 1Batch document conversionConvert an entire directory of files into Markdown format at once.
- 2Image text extractionPerform optical character recognition on image files to extract text.
- 3Automated data processingGenerate structured JSON output from document conversions for use in automated workflows.
- 4Web content parsingTurn web pages into Markdown for easier consumption by AI models.
Written from the project's README. Every use case is checked against a quote from it.
How to install markitai MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall markitai MCP in Claude Code
$ claude mcp add markitai -- uvx markitaiInstall markitai MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"markitai": {
"command": "uvx",
"args": [
"markitai"
]
}
}
}Install markitai MCP in VS Code
.vscode/mcp.json
{
"servers": {
"markitai": {
"type": "stdio",
"command": "uvx",
"args": [
"markitai"
]
}
}
}Install markitai MCP in VS Code CLI
$ code --add-mcp '{"name":"markitai","type":"stdio","command":"uvx","args":["markitai"]}'Install markitai MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"markitai": {
"command": "uvx",
"args": [
"markitai"
]
}
}
}Install markitai MCP in Codex
$ codex mcp add markitai -- uvx markitaiInstall markitai MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.markitai] command = "uvx" args = ["markitai"]
Install markitai MCP in Gemini CLI
$ gemini mcp add -s user markitai uvx -- markitaiInstall markitai MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"markitai": {
"command": "uvx",
"args": [
"markitai"
]
}
}
}Configuration
MARKITAI_HOMEMarkitai's configuration, cache and model directory (default ~/.markitai)
MODELprovider/model for --llm enhancement, e.g. gemini/gemini-flash-lite-latest; with the matching API key env var set
| Name | Description | |
|---|---|---|
| MARKITAI_HOME | Markitai's configuration, cache and model directory (default ~/.markitai) | |
| MODEL | provider/model for --llm enhancement, e.g. gemini/gemini-flash-lite-latest; with the matching API key env var set |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableynewtime/markitai is public and reachablegithub.com/ynewtime/markitai ↗Pass
- Package names this repository as its sourcemarkitai names ynewtime/markitai as sourcepypi.org/project/markitai/ ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for markitaipypi.org/project/markitai/ ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/ynewtime/markitai ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from markitaiPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubMarkitai
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 (Python 3.10+). PyPI has
wheels for these six platforms only and no 1.x any more: elsewhere pip has
nothing to install and leaves an installed 1.x as it is. Manual downloads,
updates, uninstalling and going back to 1.x 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
markitai MCP questions
How do I add markitai MCP to Claude Code?
Run claude mcp add markitai -- uvx markitai in your terminal. Add --scope user to make it available in every project.
How do I add markitai MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
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.