AInotate
Annotated screenshots for AI agents: numbered steps, arrows, boxes and solid redaction
- Pricing
- Open source
- Platforms
- macOS, Linux, Windows
- Runs
- Locally
- Version
- 0.1.9
- Listing updated
- 2 days ago
About AInotate
AInotate is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.
When an agent is asked where a setting lives, this server answers with the screen itself: it captures a web page, a window or an existing image, finds the control, and draws a numbered step beside it. It maps the text and icons on the page and places each label in free space near its target, with arrows that curve around content they would cover, then looks at the result before sending it.
It is built for several jobs: bug reports with wrong things in red and correct ones in green, step-by-step guides exported to Markdown, HTML or PDF, before and after plates for UI changes, and handoffs where the person has to act, such as a permission switch, a 2FA code or a payment. In those cases the agent shows what to press and what the click does rather than clicking. Web captures made with shoot black out emails and tokens before you see them.
It installs as a PyPI package with Homebrew, pipx or uv, or as plugins for Claude Code, Codex, Gemini CLI and Claude Desktop, and an ainotate doctor command checks screen permission, the browser and OCR. The project is free and open source and runs on your machine.
Install
Run in a terminal
claude mcp add ainotate -- uvx ainotateAdd to claude_desktop_config.json
{
"mcpServers": {
"ainotate": {
"command": "uvx",
"args": [
"ainotate"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ainotate": {
"command": "uvx",
"args": [
"ainotate"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ainotate": {
"type": "stdio",
"command": "uvx",
"args": [
"ainotate"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ainotate": {
"command": "uvx",
"args": [
"ainotate"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ainotate": {
"command": "uvx",
"args": [
"ainotate"
]
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- doctor
- Checks screen capture permission, the browser and OCR and prints fixes for anything missing.
What it does
- Page and window capture
- Captures web pages, windows or screenshots you already have.
- Smart label placement
- Labels sit in free space near targets, with arrows that avoid covering content.
- Redaction
- Emails and tokens are blacked out in web captures made with the shoot command.
- Guide export
- `ainotate guide` turns step images into Markdown, HTML or PDF guides.
- Doctor check
- Checks screen capture permission, browser and OCR and prints fixes.
- Agent skill
- A bundled skill tells the agent when to annotate on its own.
Good for
- Show where a setting is instead of describing it
- Create a step-by-step guide with one image per step
- Attach annotated screenshots to a bug report
- Mark before and after states for a changelog
- Show exactly what to click at a consent or payment screen
Pricing
Open source
Free and open source
Prices change. Check dontpayfull.com before you buy.
AInotate FAQ
Is it free?
Yes, the site describes it as free and open source and it runs on your machine.
Which agents does it work with?
Claude Code, Cowork, Claude Desktop, Codex, Gemini CLI, Cursor and other MCP clients.
What do I need installed?
Python 3.10 or newer via pipx or uv, or Homebrew on macOS; web capture needs Chromium.
Does the agent click for me?
For steps like permissions, 2FA codes or payments it shows what to press rather than clicking.
Is AInotate free?
Yes. AInotate is open source, so you can use and self-host it for free.
How do I add AInotate to Claude Code?
Run this command in your terminal: claude mcp add ainotate -- uvx ainotate
What are the best alternatives to AInotate?
The closest alternatives to AInotate are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.
Alternatives to AInotate

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory