Screencap MCP
A macOS app that remembers your screen and opens the history to agents over MCP: search, days, work threads, screenshots.
- 125 ★ on the repository
- Last commit
Broad access
Why this level
- Screen history can include messages, documents and accounts, and an agent forwards what it reads to its AI provider.
- To sort the day, captures and captions go through OpenRouter, and window titles are always sent.
Install
- Works in
Manual install
/Applications/Screencap.app/Contents/MacOS/Screencap mcp install claude-codeDownload the app from releases and turn on agent access in settings first. The command adds the MCP server and a skill.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Screen history can include messages, documents and accounts, and an agent forwards what it reads to its AI provider.
- To sort the day, captures and captions go through OpenRouter, and window titles are always sent.
This is third-party code. Review the repository files before installing.
What it does
Screencap is a macOS 26 app for Apple Silicon. It captures the screen when the picture settles, recognises text on the device, splits the day into work threads and searches any word that appeared on screen. History is stored on the Mac. Claude Code, Claude Desktop, Cursor or Codex connects through the MCP server inside the app: `Screencap mcp install claude-code` adds the server and a skill. The tools `search`, `day`, `threads`, `thread`, `activity`, `now` and `screenshot` answer questions such as "what did I read on Tuesday" or "write my standup from yesterday". Ready-made prompts `standup`, `recap` and `resume` are included.
Who it is for. Mac owners working heavily with agents who want to ask them about the past day: what was done, where work stopped, which page was open.
Good fit when
- A standup must be assembled from yesterday's windows, tabs and sessions.
- An article read last week is not in browser history but a phrase from the screen is remembered.
- Work on a task was interrupted and the agent should suggest the next step from its thread.
- An assistant needs a screenshot of a given moment instead of a retelling.
Not a fit when
- There is no Apple Silicon Mac with macOS 26: other platforms are not supported.
- The screen often shows other people's chats or confidential documents that must not be stored.
- Agents you do not control must not read the history, because screen text may contain instructions aimed at them.
Example request
Write a standup for yesterday from Screencap history, grouped by thread, and list unfinished items separately.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
Screencap stores screenshots and screen text on disk without its own encryption; protection relies on FileVault. To sort the day, captures and captions go through OpenRouter with your key; text-only mode sends no screenshots, but window titles are always sent. Agent access stays off until enabled in settings, and screenshots need a separate switch. An agent forwards what it reads to its own AI provider.
How to disable. Turn off "Let agents read my history" in Screencap settings and run `Screencap mcp uninstall claude-code`: the command removes the server entry and skill. Deleting moments erases their screenshots and text.
FAQ
How do I connect Claude Code?
Run `/Applications/Screencap.app/Contents/MacOS/Screencap mcp install claude-code`. It adds the server with `claude mcp add` and puts a skill at `~/.claude/skills/screencap/SKILL.md`.
Can agents see screenshots?
Only if "Include screenshots" is on. Access is off entirely by default, and without that switch agents read text only.
What does Screencap not capture?
Password managers, apps you exclude, private browser windows and the screen while a password field has focus. Keys and tokens on screen are replaced before storing.
How do I check the connection?
Run `Screencap mcp status`. It shows in which agents the server is registered.
Where does screen data go?
History stays on the Mac. To sort the day, captions and captures go through OpenRouter with your key, and an agent forwards what it reads to its AI provider.
Discussion
No questions or reviews yet.
Related
MCP serversA macOS menu bar app writes the text of your focused windows into markdown, and its MCP server serves that record to agents
Local screen and audio recording with natural language search, feeding your activity history to an agent via MCP
Cross-device clipboard sync with a built-in MCP server: the agent reads your copy history, and data never leaves for the cloud
A macOS app keeps a private work timeline, and its local MCP server tells an agent what you did and what is unfinished.
Mac screen HUD for agents: quotas, tokens and sessions of Claude Code, Codex and more, plus a built-in MCP server.
Local screen memory for agents: CatchMe records windows, keystrokes and clipboard, then answers questions about that history.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Screencap (this card) | no | not required | 125 | |
| screenpipe | yes | not required | 22,252 | records screen and audio across platforms; Screencap is macOS only and sorts the day into work threads |
| activity-frames | no | not required | 531 | builds activity frames by hand; Screencap captures the screen itself and serves history to agents over MCP |
README in short
The README explains the app, search, resuming work threads, the menu bar and security. Agent connection and tables of tools and prompts live in `docs/agents.md`.