skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
more-io/claude-apple-bridges68 installs

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-bridges
view source ↗

Is 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

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

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>