apple-bridges

Apple ブリッジ

~/.claude/ にある Swift CLI ツールです。Claude Code が macOS 上の Apple アプリにネイティブにアクセスできるようにします。

クイックリファレンス

ブリッジ	バイナリ	用途
reminders-bridge	~/.claude/reminders-bridge	Apple Reminders を管理 — リスト、項目、期限、繰り返し、検索
calendar-bridge	~/.claude/calendar-bridge	Apple Calendar の読み書き — イベント、空き時間、スケジュール設定
contacts-bridge	~/.claude/contacts-bridge	Apple Contacts を検索・管理 — 検索、誕生日
notes-bridge	~/.claude/notes-bridge	Apple Notes の読み書き — 作成、検索、追記
mail-bridge	~/.claude/mail-bridge	Apple Mail の読み取り・送信 — 受信トレイ、未読、作成
tmux-bridge	~/.claude/tmux-bridge	tmux セッションの読み書き — ペイン、スナップショット、キー入力の送信
messages-bridge	~/.claude/messages-bridge	Apple Messages の読み取り・送信 — チャット、未読、検索、テキストとファイルの送信

必要なブリッジの詳細ファイルをお読みください — 各ファイルには、すべてのコマンド構文、パラメーター、使用例が記載されています。

一般的なパターン

CLI 構文

すべてのブリッジは同じパターンに従います。

~/.claude/<bridge-name> <command> [arguments...]

Claude Desktop（apple-bridges-mcp 経由）では、各ブリッジは2つのツールで構成されます。読み取り専用のコマンドには <bridge>_read、リマインダーの変更などデータを書き換えるコマンドには <bridge>_write を使います（例：reminders_read と reminders_write）。コマンドを先頭にして、引数ごとに1つの要素を指定し、args 配列に同じ引数を渡してください。読み取りツールは、書き込みを行うフラグ（mail read --mark-read）を拒否します。また、tmux_write は任意のペインに入力するため、セッション全体に対して許可すべきツールではありません。

引用符の使用

スペースを含む引数は引用符で囲む必要があります。

~/.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"

破壊的な操作

削除コマンドは、既定でドライランを行います。--force フラグを付けずに実行すると、削除される内容が表示されます。

# Dry run (safe preview)
~/.claude/reminders-bridge delete "Work" "Old task"

# Actually delete
~/.claude/reminders-bridge delete "Work" "Old task" --force

これは次のコマンドに適用されます：reminders-bridge delete、calendar-bridge delete、contacts-bridge delete、notes-bridge delete、mail-bridge delete。

権限

各ブリッジの初回使用時には、macOS の権限が必要です。

ブリッジ	権限	設定パス
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	なし（tmux CLI を使用）	—
messages-bridge	Full Disk Access（読み取り）+ Automation (Messages.app)	Privacy & Security > Full Disk Access / Automation

許可するツールの設定

.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:*)"
    ]
  }
}