49 more-io

apple-bridges Skill

当用户问到 Apple 应用时使用此技能——提醒事项、日历、通讯录、备忘录、邮件、信息(iMessage/SMS),或 tmux 会话。包括创建/完成提醒、查看/添加日历事件、查找联系人、读写备忘录、收发邮件、收发 iMessage 和短信,以及捕获 tmux 会话内容。用户提到任务、待办、日程、生日、空闲时段或每日总结时也可使用。桥接工具是安装在 ~/.claude/ 下的 CLI 工具,让 Claude Code 在 macOS 上原生访问这些 Apple 应用。

安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。

查看源码

技能指令原文(SKILL.md)

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: _read for commands that only read and _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:*)"
    ]
  }
}