apple-bridges
Use this skill whenever the user asks about Apple apps — Reminders, Calendar, Contacts, Notes, Mail, Messages (iMessage/SMS), or tmux sessions. This includes creating/completing reminders, checking/adding calendar events, looking up contacts, reading/writing notes, sending/reading email, reading/sending iMessages and texts, and capturing tmux session content. Also use this skill when the user mentions tasks, todos, scheduling, birthdays, free time slots, or end-of-day summaries. The bridges are CLI tools installed at ~/.claude/ that give Claude Code native access to these Apple apps on macOS.
How do I install this agent skill?
npx skills add https://github.com/more-io/claude-apple-bridges --skill apple-bridgesIs this agent skill safe to install?
- Gen Agent Trust Hubfail
The skill provides access to highly sensitive macOS data including Messages, Mail, Contacts, and Calendar. It also includes a bridge to tmux that explicitly supports executing sudo commands. The skill is susceptible to indirect prompt injection as it reads content from external sources that could contain malicious instructions.
- Socketwarn
2 alerts: gptAnomaly
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerpass
7 files scanned · No issues
What does this agent skill do?
Apple Bridges
Swift CLI tools at ~/.claude/ that give Claude Code native access to Apple apps on macOS.
Quick Reference
| Bridge | Binary | Purpose |
|---|---|---|
| reminders-bridge | ~/.claude/reminders-bridge | Manage Apple Reminders — lists, items, due dates, repeats, search |
| calendar-bridge | ~/.claude/calendar-bridge | Read/write Apple Calendar — events, free slots, scheduling |
| contacts-bridge | ~/.claude/contacts-bridge | Search/manage Apple Contacts — lookup, birthdays |
| notes-bridge | ~/.claude/notes-bridge | Read/write Apple Notes — create, search, append |
| mail-bridge | ~/.claude/mail-bridge | Read/send Apple Mail — inbox, unread, compose |
| tmux-bridge | ~/.claude/tmux-bridge | Read/write tmux sessions — panes, snapshots, send keystrokes |
| messages-bridge | ~/.claude/messages-bridge | Read/send Apple Messages — chats, unread, search, send text and files |
Read the detail file for the bridge you need — each contains full command syntax, all parameters, and usage examples.
General Patterns
CLI Syntax
All bridges follow the same pattern:
~/.claude/<bridge-name> <command> [arguments...]
In Claude Desktop (via apple-bridges-mcp), each bridge is two tools: <bridge>_read for commands that only read and <bridge>_write for commands that change data, such as reminders_read and reminders_write. Pass the same arguments as the args array, one element per argument, starting with the command. A read tool refuses a flag that would write (mail read --mark-read), and tmux_write types into any pane, so it is never a tool to allow for a whole session.
Quoting
Arguments with spaces must be quoted:
~/.claude/reminders-bridge add "Shopping List" "Buy milk" "From the organic store"
~/.claude/calendar-bridge add "Work" "Team Meeting" "2026-03-01 10:00" "2026-03-01 11:00"
Destructive Operations
Delete commands use a dry-run by default pattern — they show what would be deleted without the --force flag:
# Dry run (safe preview)
~/.claude/reminders-bridge delete "Work" "Old task"
# Actually delete
~/.claude/reminders-bridge delete "Work" "Old task" --force
This applies to: reminders-bridge delete, calendar-bridge delete, contacts-bridge delete, notes-bridge delete, mail-bridge delete.
Permissions
Each bridge requires macOS permission on first use:
| Bridge | Permission | Settings Path |
|---|---|---|
| reminders-bridge | Reminders | Privacy & Security > Reminders |
| calendar-bridge | Calendars | Privacy & Security > Calendars |
| contacts-bridge | Contacts | Privacy & Security > Contacts |
| notes-bridge | Automation (Notes.app) | Privacy & Security > Automation |
| mail-bridge | Automation (Mail.app) | Privacy & Security > Automation |
| tmux-bridge | None (uses tmux CLI) | — |
| messages-bridge | Full Disk Access (read) + Automation (Messages.app) | Privacy & Security > Full Disk Access / Automation |
Allowed Tools Configuration
Add to .claude/settings.local.json:
{
"permissions": {
"allow": [
"Bash(~/.claude/reminders-bridge:*)",
"Bash(~/.claude/calendar-bridge:*)",
"Bash(~/.claude/contacts-bridge:*)",
"Bash(~/.claude/notes-bridge:*)",
"Bash(~/.claude/mail-bridge:*)",
"Bash(~/.claude/tmux-bridge:*)",
"Bash(~/.claude/messages-bridge:*)"
]
}
}
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/more-io/claude-apple-bridges/apple-bridges">View apple-bridges on skillZs</a>