Give Claude, ChatGPT and Codex your screenshots
Capturist keeps your Mac screenshots, saved text and clipboard in one private library and reads the words inside every screenshot. Its local MCP server lets the AI apps you already use find and read them: no dragging files into chats, nothing uploaded by Capturist.
What you can ask
- “Fix the failing test from my last screenshot.”
- “Find the screenshot with the invoice from Acme and read me the total.”
- “What did the error I captured an hour ago say?”
- “Save this checklist to my Capturist snippets.” (only if you allow agents to save)
Set it up
1. Install Capturist: the free beta, Capturist Complete, or Capturist from the Mac App Store.
2. Install the capturist command (signed by us, notarized by Apple). The Capturist Complete installer already does this.
curl -fsSL https://capturist.nodetools.org/install-cli.sh | bash
Or with Homebrew: brew install vortex-303/tap/capturist. For Claude desktop there's also a one-click bundle: download capturist.mcpb and open it.
3. Connect the apps you use, then reopen them:
| App | Command |
|---|---|
| Claude (desktop app) | capturist setup claude-desktop |
| ChatGPT (desktop app) and Codex | capturist setup chatgpt |
| Claude Code | capturist setup claude-code |
| Codex CLI | capturist setup codex |
| Cursor, OpenCode | Capturist › Settings › AI Agents › Connect… |
| Any MCP client | {"command": "capturist", "args": ["mcp"]} |
Inside Capturist, Settings › AI Agents has the same commands with Copy buttons.
How it works
capturist mcp is a standard MCP server over stdio. When Capturist (1.1 or later) is open with Settings › AI Agents on, it relays to the app's own server on 127.0.0.1, so your AI apps get every tool, including saving to your library if you allow it. When the app is closed, or on Capturist 1.0, it reads your library directly, read-only.
| Your Capturist | What AI apps get |
|---|---|
| 1.1 or later, or Capturist Complete, with AI Agents on | All tools, through the app |
| Capturist 1.0, or the app closed | Read-only access to your library |
Tools
| Tool | What it does |
|---|---|
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, save_image | Add text or an image to your library (off until you allow it; images up to 10 MB, 60 saves an hour) |
Privacy and security
- Text inside screenshots is read on your Mac with Apple's on-device Vision framework.
- Capturist's server listens on 127.0.0.1 only, needs a private key, and refuses requests from web pages.
- AI Agents is off until you turn it on. Letting agents save to your library is a separate switch.
- Capturist sends nothing to any AI company. When an AI app reads a capture, what it does with it depends on that app, the same as any file you give it.
Requirements
A Mac with macOS 14 Sonoma or later, Apple silicon or Intel. This is a local server: it works on the Mac where Capturist is installed, not as a hosted service.
Open source
The capturist command and MCP server are open source under the MIT license: github.com/vortex-303/capturist-mcp. The Capturist app itself is not.