your apple apps, as tools
Calendar, Reminders, Mail, Notes, Contacts and Messages, over MCP: 46 tools your agent can call, each with a matching CLI verb, running through Apple's own frameworks — EventKit, Contacts and ScriptingBridge, no osascript processes. A local index makes Mail search milliseconds, and none of it ever leaves your Mac.
cargo install bite-mcp$ search meeting --limit 8{ "hits": [ { "account": "Ktesio", "app": "mail", "container": "INBOX", "flagged": false, "id": "542693", "junk": false, "participants": "Notion Team <team@mail.notion.so>", "read": false, "snippet": "Notes tailored to your meeting \n\nEvery meeting is different. A daily standup with your team. That client call. An impromptu brainstorm. There’s no one-size-fits-all summary and they all deserve good …", "start_ms": 1790496079000, "title": "Perfect meeting memory", "updated_ms": 1790496079000 }, { "account": "iCloud", "app": "mail", "container": "INBOX", "flagged": false, "id": "543043", "junk": false, "participants": "Notion Team <team@mail.notion.so>", "read": false, "snippet": "Get perfect notes, every time \n\nIt’s hard to lead a meeting and take notes all at once. That’s where AI Meeting Notes comes in: it handles the notes so you can stay fully present, think clearly, and …", "start_ms": 1790236806000, "title": "Let AI take the notes next meeting", "updated_ms": 1790236806000 }, { "account": "iCloud", "app": "reminders", "completed": true, "container": "Today", "id": "444EC36E-1DFA-5BBD-949B-10C9C509D4F4", "start_ms": 1567088100000, "title": "Have a meeting with my team" } ], "note": "search covers whatever has been indexed — run index_rebuild to refresh", "total": null}$ bite doctorbite doctor────────────────────────────────────────────────────────────✓ macOS 27.0.1 (major 27)✓ /usr/bin/swiftc✓ capabilities: calendar, reminders, contacts, mail, notes, messages✓ a system prompt appears on first use✓ a system prompt appears on first use✓ a system prompt appears on first use✓ a system prompt appears on first use✓ a system prompt appears on first use✓ a system prompt appears on first use✓✓ data dir /Users/you/Library/Application Support/bite — 23.6 MB (index.lance 22.6 MB, bin 1.1 MB, batches 0 B) cargo target 7.9 GB — `cargo clean` reclaims it○ → run `bite setup` to register the MCP server ZCode zcode○ → run `bite setup` to register the MCP server✓ Cursor cursor○ → run `bite setup` to register the MCP server Gemini CLI gemini────────────────────────────────────────────────────────────all checks passed$ index status{ "crawl": { "alive": true, "state": { "failures": 16, "found": 821, "job_id": "crawl-1792783683", "processed": 865, "skipped": 45, "state": "running", "updated_at": "2026-10-23T19:48:08Z", "window": "1790191683019-1792783683019" } }, "fts_indexed": true, "jobs": { "jobs": [], "pending_batches": 0 }, "newest_updated_ms": 1792783360000, "pending_batches": 0, "per_app": [ { "app": "mail", "rows": 4479 }, { "app": "reminders", "rows": 785 }, { "app": "contacts", "rows": 2320 } ], "total": 7584}$ mail accounts{ "accounts": [ { "email": "you@icloud.com", "name": "iCloud" }, { "email": "hello@ktesio.com", "name": "Ktesio" } ]}Illustration: the sidebar lists the six apps and their tool counts. The panes show real bite 0.5.0 output; personal senders, subjects and account names are redacted, and duplicate or personal search hits are omitted.
Calendar, Reminders, Mail, Notes, Contacts and Messages, each through its native engine: EventKit and Contacts.framework where Apple provides one, ScriptingBridge where it doesn't. The helper installs once at a stable path, so macOS permission grants survive every upgrade.
MCP schemas and CLI verbs are generated from the same table, so reminders_create and bite reminders create can never drift — a CI conformance test fails the build if they do. Agents get typed tools; you get the same verbs in your terminal.
A detached crawl worker indexes Mail into a local LanceDB database — the newest 30 days first, then backfill to a year, deltas after that — and searches answer from the index: 8–10 ms full-text on the 124k-message benchmark, no Apple Events on the query path.
Calendar, Reminders and Contacts mirror into the same index for the unified search tool.
Every macOS prompt is one-time and attributed where you'd expect it; every denial returns an exact fix — a command or a System Settings deep link your agent relays verbatim. bite doctor shows the whole state without raising a prompt, and --fix opens the right pane for anything denied.
No server, no account, no telemetry. Everything — index, crawl batches, helper — lives in one 0700 data dir, purged on demand: index_forget drops a scoped range after a preview and stays dropped across re-crawls; rebuilds can skip message bodies entirely.
Bulk mark, move and delete run as one script per operation through the crawl worker — a handful of Apple Events total where per-message MCPs send thousands — and every one previews first: confirm_required: true with the selection spelled out until you pass confirm.
More from Ktesio
One command installs bite and its native helper; bite setup then writes the MCP config into every agent CLI it finds — Claude Code, ZCode, Codex, OpenCode, Cursor, VS Code, Gemini.
cargo install bite-mcp