Keeploop plugin for Claude Code, Cursor and Grok Build
Keeploop is the personal context layer for your AI: a Mac menu bar app
that lets the AI apps you already use read your Mail, Messages, Calendar, Notes and Slack, right
on your Mac. Your data stays on your Mac, and you decide what each AI can see and do.
This repository is the plugin marketplace for Keeploop. The plugin adds:
- The Keeploop tools (mail, threads and attachments, calendar and free time, messages, notes,
contacts and Slack, monitors that wake the agent when a reply lands, drafts in your voice).
They come from the Keeploop app through a small launcher; nothing in this repository reads
your data itself.
- The
/keep- commands:
| Command | What it does |
|---|
/keep-today | Today's schedule, the replies you owe, and today's monitor hits |
/keep-free [length and range] | Open slots on your calendar, for example /keep-free 30m this week |
/keep-brief [account or category] | Unread mail, what needs a reply, and today's monitor hits |
/keep-reply | Threads where someone is waiting on you, with a suggested next step each |
/keep-thread <subject or mail id> | Summarize a whole conversation: decisions and open questions |
/keep-draft <mail id> <what to say> | Draft a threaded reply that sounds like you. Saves a draft only |
/keep-find <description> | Find a file someone sent you by describing it |
/keep-waiting | Mail you sent that nobody has answered yet, oldest first |
/keep-settings [what to change] | See what the AI can do, or propose a change for approval on your Mac |
/keep-help | List the commands |
Requirements
- An Apple Silicon Mac on macOS 26 or later.
- The Keeploop app, installed in
/Applications (or ~/Applications) and opened once.
Get it at keeploop.app. Without the app the plugin's server stops with
"Keeploop is not installed on this Mac. Install Keeploop from https://keeploop.app ...".
If you already have Keeploop, the easiest route is Keeploop > Settings > Connect, which installs
this plugin for you.
Install
Claude Code
/plugin marketplace add keeploopapp/claude-plugin
/plugin install keeploop@keeploop
Or from a terminal:
claude plugin marketplace add keeploopapp/claude-plugin
claude plugin install keeploop@keeploop
Restart Claude Code, then type /keep-help.
Cursor
Install Keeploop from the Cursor Marketplace in Customize, or add this repository as a
plugin source. The plugin reports itself to Keeploop as Cursor, so Keeploop's per-app rules apply.
Grok Build
Grok Build reads Claude Code marketplaces, so the Claude Code commands above are all it needs.
Web and phone AI apps (Claude, ChatGPT, Grok, Poke and others)
The plugin is for AI apps on your Mac. To use Keeploop from claude.ai, ChatGPT (including dots),
grok.com, Poke or any app that can add a custom MCP connector, add this one URL:
https://mcp.keeploop.app/mcp
Sign in to Keeploop in the window the app opens, then approve the app on your Mac. The same URL
works for every user; it reaches your Mac only after you approve it there. Remote apps are Read
only until you allow more in Keeploop. Step by step for each app:
https://keeploop.app/your-ai-apps.
What the plugin contains
plugins/keeploop/server/keeploop-mcp: a shell launcher that runs the connector inside
Keeploop.app (its signed Contents/MacOS/keeploop-mcp). The Keeploop app checks that
signature and applies your permissions to every call.
plugins/keeploop/skills/keep-*: the commands, as plain Markdown.
plugins/keeploop/hooks/hooks.json: a Claude Code SessionStart hook that tells Keeploop
which session is running, so a monitor can wake the session that asked for it. It does nothing
when the app is not installed.
.claude-plugin/ and .cursor-plugin/: the marketplace manifests.
Nothing in the plugin makes a network connection, downloads code or installs packages. The
launcher only runs the Keeploop app's connector on your Mac, and that talks to the Keeploop app
over a local connection, so there is no Keeploop server in the path. If you also use Keeploop from
a web or phone AI app, that is a separate connection: your data stays on your Mac, and Keeploop's
connection service passes requests to your Mac and results back. It never stores them. What the
app itself can send, and only when you turn it on, is listed in the
privacy policy.
Privacy Policy
The full policy is at https://keeploop.app/privacy. In short:
- Collection: this plugin collects nothing. It starts the Keeploop app's connector, which
reads the Apple Mail data (and any other source you turn on) already on your Mac, only when
your AI app calls a tool.
- Use and storage: results go to the AI app that asked, on your Mac. Keeploop keeps its
settings and monitors on your Mac only.
- Sharing: none. With the plugin there is no Keeploop server in the path. If you also use
the web and phone URL above, our connection service passes requests to your Mac and results
back and never stores them.
- Retention: the plugin keeps no data. The connection service keeps account, device and
approval records until you delete them, and security event metadata for 30 days.
- Contact: help@keeploop.app
Support
License
The files in this repository are MIT licensed (see LICENSE). The Keeploop app itself is
separate, proprietary software and is not part of this repository.
This repository is generated from the Keeploop release build; please send changes as issues
rather than pull requests.