我用 TypeScript 做了一个 iCloud Calendar MCP
AI 已经可以写代码、查资料和管理文件，现在它也可以管理你的 iCloud 日历。
最近我开源了 iCloud Calendar MCP：一个使用 TypeScript 开发、通过 CalDAV 连接 Apple iCloud Calendar 的 MCP Server 。
- GitHub： https://github.com/IceyWu/icloud-calendar-mcp
- npm： https://www.npmjs.com/package/icloud-calendar-mcp
它能做什么
接入支持 MCP 的客户端后，可以直接用自然语言操作日历：
查询我明天的日程。
明天上午十点创建一个 30 分钟的项目讨论。
检查明天下午有没有时间冲突。
把周五的会议调整到下周一上午。
目前提供这些工具：
- 查询日历和事件
- 创建、修改和删除事件
- 检查日程冲突
- 计算忙闲时间
- 处理全天事件、时区、提醒和参与者
- 支持 RRULE 重复事件及 occurrence 查询
快速开始
准备好 Apple 账户邮箱和应用专用密码。不要使用 Apple 账户主密码。
在 MCP 客户端中添加：
{
"mcpServers": {
"icloud-calendar": {
"command": "npx",
"args": ["-y", "icloud-calendar-mcp"],
"env": {
"ICLOUD_USERNAME": "[email protected]",
"ICLOUD_APP_PASSWORD": "xxxx-xxxx-xxxx-xxxx"
}
}
}
}
重启客户端后，就可以让 AI 查询或安排日程。
不只是简单包装 CalDAV
日历写入很容易遇到重复创建和并发覆盖。项目为此加入了：
request_id和稳定 UID ，降低重复创建风险If-None-Match、If-Match和 ETag 并发控制- 本地请求日志和可跨进程复用的事件 handle
- 超时、指数退避、
Retry-After和写后读取处理 - 密码、Authorization 、敏感 URL 与事件内容脱敏
项目也明确处理了时区、夏令时和全天事件语义。对于无法安全完成的重复事件修改，会返回明确错误，而不是静默改错整个系列。
为什么选择 TypeScript
我希望它能通过 npm 直接使用，不要求安装 Java 、Python ，也不依赖 macOS 、AppleScript 或 Calendar.app：
npx -y icloud-calendar-mcp
项目使用官方 @modelcontextprotocol/sdk，默认通过 stdio 运行，同时保留经过认证和安全限制的 Streamable HTTP 模式。
CI 使用 fake CalDAV Server ，不需要真实 Apple 账号，覆盖了 MCP 握手、事件 CRUD 、幂等重放、ETag 冲突、重复事件、DST 、限流和重试等场景。
如果你正在使用 Codex 、Claude Desktop 、Cursor 或其他支持 MCP 的客户端，欢迎试用：
https://github.com/IceyWu/icloud-calendar-mcp
也欢迎提交 Issue 或 PR ，一起完善 iCloud Calendar 的 MCP 使用体验。
Select Language