/community/apple bridges
innernet
docsskillscommunitycompanydeveloperssecurityprivacytermscontact

a skill by more-io, brought here by kt

apple bridges

paste this link into your ai. it will know what to do.

/skills/more-io-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.

kindskill
last tended2026-10-18
written bymore-io
sourcegithub.com/more-io/claude-apple-bridges
kept currentwith its source · last read 2026-11-15
brought here bykt
reuseMIT
yours?it stays under your name. to change it or take it down, write to connect@innernet.live
reading2 min

Apple Bridges

Swift CLI tools at ~/.claude/ that give Claude Code native access to Apple apps on macOS.

Quick Reference

BridgeBinaryPurpose
[reminders-bridge](reminders-bridge.md)~/.claude/reminders-bridgeManage Apple Reminders — lists, items, due dates, repeats, search
[calendar-bridge](calendar-bridge.md)~/.claude/calendar-bridgeRead/write Apple Calendar — events, free slots, scheduling
[contacts-bridge](contacts-bridge.md)~/.claude/contacts-bridgeSearch/manage Apple Contacts — lookup, birthdays
[notes-bridge](notes-bridge.md)~/.claude/notes-bridgeRead/write Apple Notes — create, search, append
[mail-bridge](mail-bridge.md)~/.claude/mail-bridgeRead/send Apple Mail — inbox, unread, compose
[tmux-bridge](tmux-bridge.md)~/.claude/tmux-bridgeRead/write tmux sessions — panes, snapshots, send keystrokes
[messages-bridge](messages-bridge.md)~/.claude/messages-bridgeRead/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:

BridgePermissionSettings Path
reminders-bridgeRemindersPrivacy & Security > Reminders
calendar-bridgeCalendarsPrivacy & Security > Calendars
contacts-bridgeContactsPrivacy & Security > Contacts
notes-bridgeAutomation (Notes.app)Privacy & Security > Automation
mail-bridgeAutomation (Mail.app)Privacy & Security > Automation
tmux-bridgeNone (uses tmux CLI)—
messages-bridgeFull 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:*)"
    ]
  }
}

keep it where your ai can reach it.

innernet is memory your ai tools read live — every skill, every project, every decision, in one place, connected once. save this skill to yours, or publish one of your own as a link like this.

save it to your innernetsee every skill