cider (Proxynico)

苹果酒

适用于macOS上Claude Code、Codex和其他AI助手的本地Apple日历、笔记和联系人工具。

Cider允许AI助手使用Mac上已有的Apple应用程序。

它将Claude Code、Codex或其他MCP客户端连接到：

• 苹果日历
• 苹果笔记
• 苹果联系人
• 一 doctor 检查告诉您设置是否正常

您只需安装一次，注册一个MCP服务器，批准正常的macOS隐私提示，然后您的助手就可以从本地计算机帮助处理日历事件、笔记和联系人。

MCP是Claude Code和Codex等助手使用的工具/插件连接。在实践中，苹果酒是你的助手和苹果应用程序之间的桥梁。

它能做什么

日历：

• 列出您的日历
• 按日期范围搜索事件
• 创建事件
• 更新事件
• 删除事件
• 使用事件ID，这样“午餐”或“通话”等常见标题就不会出现错误的事件

笔记：

• 列出文件夹和笔记
• 阅读和搜索笔记
• 创建、附加、移动、更新和删除笔记

联络：

• 列出和搜索联系人
• 阅读联系方式
• 创建、更新和删除联系人

诊断：

• 跑 doctor 确认Bun、AppleScript、日历助手、日历访问、笔记访问和联系人访问是否正常工作。

安装

git clone https://github.com/proxynico/cider.git
cd cider
bun install
bun run build:swift

bun run build:swift 创建小签名 苹果酒日历助手 macOS用于日历权限的应用程序。

使用克劳德代码注册

claude mcp add --scope user cider -- bun run /path/to/cider/src/index.ts
claude mcp get cider

本地结账示例：

claude mcp add --scope user cider -- bun run /Users/nicolasmontero/Developer/cider/src/index.ts

注册或更新Cider后重新启动Claude Code。

在Codex注册

codex mcp add cider -- bun run /path/to/cider/src/index.ts
codex mcp list

本地结账示例：

codex mcp add cider -- bun run /Users/nicolasmontero/Developer/cider/src/index.ts

注册或更新苹果酒后重新启动Codex。

批准macOS权限

macOS控制对日历、笔记和联系人的访问。苹果酒无法绕过这些提示，这是一件好事。

注册后，请您的助手运行：

doctor

然后尝试一个无害的日历阅读：

calendar_list_calendars

如果macOS要求访问日历，请批准。

如果没有出现提示，请打开：

System Settings > Privacy & Security > Calendars

确保 苹果日历助手 已启用 完全访问.

对于笔记和联系人，请使用：

System Settings > Privacy & Security > Automation

如果macOS要求，允许您的MCP客户端或终端应用程序控制笔记和联系人。

检查它是否有效

从你的助手那里，运行：

doctor

健康的设置如下：

OK bun
OK osascript
OK Notes automation
OK Contacts automation
OK calendar helper
calendar authorization: authorized
OK calendar permission: granted

然后尝试：

calendar_list_calendars
notes_list_folders
contacts_list

如果这些方法奏效，苹果酒已经准备好了。

安全使用日历

日历搜索返回 eventId.用这个 eventId 更新或删除事件时。

这比仅按标题更新更安全，因为许多日历都有重复的标题，如“会议”、“午餐”或“通话”。

示例流程：

1. 在日期范围内搜索事件。
2. 从结果中选择正确的事件。
3. 使用它 eventId 更新或删除它。

修改日历、笔记和联系人工具也支持 dryRun: true 如果可用，您的助手可以在更改任何内容之前预览该操作。

日期

使用ISO样式日期：

2026-05-12
2026-05-12T10:30:00
2026-05-12T10:30:00Z
2026-05-12T10:30:00+02:00

仅日期值表示Mac上的本地午夜。

故障排除

跑 doctor 第一。这是查看损坏情况的最快方法。

如果日历显示 notDetermined 或否认：

• 跑 calendar_list_calendars
• 如果出现提示，则批准该提示
• 检查一下 苹果日历助手 在日历隐私设置中启用
• 更改权限后重新启动MCP客户端

如果笔记或联系人失败：

• 检查运行Cider的应用程序的自动化权限
• 更改权限后重新启动MCP客户端

如果工具消失或仍使用旧行为：

• 退出旧的克劳德/法典会议
• 启动一个新会话，以便MCP服务器重新加载最新代码

发展

有用的命令：

bun install
bun run build:swift
bun run test
bun run src/index.ts

在装运更改之前，运行：

bun run build:swift
bun run test
git diff --check

对于完整的活烟测试，还要验证：

• doctor
• calendar_list_calendars
• 临时日历创建/更新/删除
• 如果这些表面发生变化，则创建/读取/删除临时注释和联系人

运作原理

Cider是一个本地MCP服务器。TypeScript服务器公开了这些工具。Calendar使用一个小型的签名助手应用程序，因为macOS将Calendar权限授予应用程序，而不是匿名后台脚本。笔记和联系人使用Apple自动化。

不需要云帐户、API密钥或外部数据库。访问权限保留在Mac上，并由macOS隐私设置控制。

许可证

麻省理工学院