Skip to content
MCP server

AInotate

Annotated screenshots for AI agents: numbered steps, arrows, boxes and solid redaction

Runs locallyStatus and history
Install
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 ainotate

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ainotate": {
      "command": "uvx",
      "args": [
        "ainotate"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ainotate": {
      "command": "uvx",
      "args": [
        "ainotate"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory