apple-bridges
Use this skill whenever the user asks about Apple apps — Reminders, Calendar, Contacts, Notes, Mail, or tmux sessions. This includes creating/completing reminders, checking/adding calendar events, looking up contacts, reading/writing notes, sending/reading email, 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.
pinned to #8e9890fupdated 2 weeks ago
Ask your AI client: “install skills/apple-bridges”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install skills/apple-bridgesmetahub onboarded this repo on the author's behalf.
If you own github.com/more-io/claude-apple-bridges on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
29
Last commit
2 weeks ago
Latest release
published
- #ai-agents
- #apple
- #claude-code
- #cli
- #contacts
- #eventkit
- #macos
- #mcp
- #notes
- #skills
- #swift
- #tmux
- #workflow-automation
About this skill
Pulled from SKILL.md at publish time.
Swift CLI tools at `~/.claude/` that give Claude Code native access to Apple apps on macOS.
Evaluation report
WarningsAutomated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.8e9890f· 2 weeks ago
Kind-specific
31Skill: SKILL.md present
found at skills/apple-bridges/SKILL.md · frontmatter source: SKILL.md
Skill: body content present
342 words · 2,793 chars · 7 sections · 4 code blocks
Skill: triggers declaredwarn
No `trigger` phrases in SKILL.md frontmatter
Add `trigger:` lines so Claude knows when to activate this skill — e.g. `when building MCP servers` or `for diagram creation`.
Skill: allowed-tools scope
no allowed-tools restriction (Claude may use anything)
Release history
1- releasecurrent8e9890fwarn2 weeks ago
Contents
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, 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 |
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...]
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) | — |
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:*)"
]
}
}
Reviews
No reviews yet. Be the first.
Related
orchestration-patterns
>
migration-patterns
>
deployment-sop
>
mh install skills/apple-bridges