# Capturist

> Capturist is an open-source MCP server for developer tools. Lets AI assistants search and read your Mac screenshots, snippets and clipboard locally. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI, API
- **Website:** https://capturist.nodetools.org/ai/
- **Repository:** https://github.com/vortex-303/capturist-mcp
- **MCP Registry name:** io.github.vortex-303/capturist-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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)

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/capturist
