Skip to content
MCP server

Capturist

Lets AI assistants search and read your Mac screenshots, snippets and clipboard locally

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, CLI, API
Runs
Locally
Version
0.4.2
Listing updated
today

About Capturist

Capturist is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

The README and product page present Capturist's MCP server as a bridge between a Mac screenshot library and AI apps such as Claude, ChatGPT, Codex and Cursor. Captures, saved text and clipboard history are kept in one local library, and text inside screenshots is recognized on the Mac with Apple's on-device Vision framework, so assistants can search for an invoice total or the last error message without files being dragged into a chat.

The server is a command line tool called capturist that speaks MCP over stdio. When the Capturist app is open with AI Agents turned on, it relays requests to the app's own server on 127.0.0.1, which exposes the full tool set. When the app is closed or running version 1.0, the server reads the library directly in read-only mode.

According to the product page, saving snippets or images back to the library is a separate switch that stays off until the user enables it, and the server requires a private key and refuses requests from web pages. The Capturist app itself is closed source and requires macOS 14 or later.

Install

Run in a terminal

claude mcp add capturist-mcp -- npx -y https://github.com/vortex-303/capturist-mcp/releases/download/v0.4.2/capturist.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "capturist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vortex-303/capturist-mcp/releases/download/v0.4.2/capturist.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "capturist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vortex-303/capturist-mcp/releases/download/v0.4.2/capturist.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "capturist-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vortex-303/capturist-mcp/releases/download/v0.4.2/capturist.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "capturist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vortex-303/capturist-mcp/releases/download/v0.4.2/capturist.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "capturist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/vortex-303/capturist-mcp/releases/download/v0.4.2/capturist.mcpb"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

recent_captures
Newest captures, optionally since a time or of one kind
search_captures
Search names, source app, window title and the text inside screenshots
get_capture
One capture: details, the text inside it, and the image itself
capture_text
Just the text inside a capture (fast for errors, logs, code)
recent_clips
Recent clipboard text, if clipboard history is on
save_snippet
Add text to your library (off until you allow it)
save_image
Add an image to your library (off until you allow it; up to 10 MB, 60 saves an hour)

What it does

Searchable screenshot text
Searches names, source app, window title and the text recognized inside screenshots.
Recent captures access
Lists the newest screenshots, saved text or clipboard items, optionally filtered by time or kind.
Clipboard history reading
Returns recent clipboard text when clipboard history is turned on in Capturist.
Optional saving to library
Lets agents add text snippets or images to the library, but only after the user allows it.
Local-only server
Runs on the Mac and listens on 127.0.0.1 with a private key, with no hosted service involved.
One-command setup
Connects Claude, ChatGPT, Codex, Claude Code and Cursor through capturist setup commands.

Good for

  • Asking an AI assistant to fix a failing test shown in a recent screenshot
  • Finding an invoice screenshot and reading out its total
  • Retrieving the error text from a capture taken earlier
  • Saving a checklist from a chat into a Capturist snippet collection

Pricing

Open source

MCP server and CLI are MIT-licensed and free; the Capturist app is available as a free beta, Capturist Complete, or from the Mac App Store.

Prices change. Check capturist.nodetools.org before you buy.

Capturist FAQ

Does Capturist upload my screenshots?

The product page says Capturist sends nothing to any AI company and the server is local. What an AI app does with a capture it reads depends on that app.

Which macOS versions are supported?

macOS 14 Sonoma or later, on Apple silicon or Intel.

Is the MCP server open source?

The capturist command and MCP server are published under the MIT license on GitHub. The Capturist app itself is not open source.

Do I need the Capturist app installed?

Yes. The README says the free beta, Capturist Complete or the Mac App Store version of Capturist must be installed.

Is Capturist free?

Yes. Capturist is open source, so you can use and self-host it for free.

How do I add Capturist to Claude Code?

Run this command in your terminal: claude mcp add capturist-mcp -- npx -y https://github.com/vortex-303/capturist-mcp/releases/download/v0.4.2/capturist.mcpb

What are the best alternatives to Capturist?

The closest alternatives to Capturist are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers

Alternatives to Capturist

  1. REA

    MCP server

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

    Runs locally
    • Open source
    • 467K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

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

    Runs locally
    • Open source
    • 48.8K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

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

    • Remote
    • Open source
    • 34.6K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. 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
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools