mcpField
A
apple-bridges

apple-bridges

github.com/more-io生产力4966 次安装2 周前更新
代码仓库

关于 apple-bridges

Apple Bridges 是一组 Swift 命令行工具，让 Claude Code 可在 macOS 上操作 Apple 应用和 tmux。通过 apple-bridges-mcp 提供独立的读取与写入工具；删除操作默认先预览，强制标志除外。

主要功能

  1. 01管理提醒事项和日历
  2. 02搜索和管理联系人与备忘录
  3. 03读取和发送邮件与信息
  4. 04读取和控制 tmux 会话
  5. 05通过 MCP 区分读写工具

适用场景

  1. 01添加或查看提醒事项和日历事件
  2. 02搜索联系人或编辑备忘录
  3. 03查看收件箱或发送信息
  4. 04检查 tmux 窗格或发送按键

MCP 相关

通过 apple-bridges-mcp，桥接工具以独立的读取和写入工具形式提供给 Claude Desktop。读取工具会拒绝可能更改数据的标志。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/more-io/claude-apple-bridges --skill apple-bridges

安装后在 Claude Code 中输入/apple-bridges确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

calendar-bridge.md
contacts-bridge.md
mail-bridge.md
messages-bridge.md
notes-bridge.md
reminders-bridge.md
tmux-bridge.md

详细介绍

Apple Bridges

位于 ~/.claude/ 的 Swift CLI 工具，让 Claude Code 能在 macOS 上原生访问 Apple 应用。

快速参考

Bridge二进制文件用途
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 — 聊天、未读消息、搜索、发送文本和文件

请阅读所需 Bridge 的详细文件 — 每个文件都包含完整的命令语法、所有参数和用法示例。

通用模式

CLI 语法

所有 Bridge 都遵循相同模式：

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

在 Claude Desktop 中（通过 apple-bridges-mcp），每个 Bridge 都对应两个工具：<bridge>_read 用于仅读取的命令，<bridge>_write 用于会更改数据的命令，例如 reminders_read 和 reminders_write。参数与 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。

权限

每个 Bridge 首次使用时都需要 macOS 权限：

Bridge权限设置路径
reminders-bridgeReminders隐私与安全性 > Reminders
calendar-bridgeCalendars隐私与安全性 > Calendars
contacts-bridgeContacts隐私与安全性 > Contacts
notes-bridge自动化（Notes.app）隐私与安全性 > 自动化
mail-bridge自动化（Mail.app）隐私与安全性 > 自动化
tmux-bridge无（使用 tmux CLI）—
messages-bridge完全磁盘访问权限（读取）+ 自动化（Messages.app）隐私与安全性 > 完全磁盘访问权限 / 自动化
允许的工具配置

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

评论

支持 Markdown