我用 TypeScript 做了一个 iCloud Calendar MCP，让 AI 真正管理你的日历

发布于 2026-08-18 15:35:34

# 我用 TypeScript 做了一个 iCloud Calendar MCP

AI 已经可以写代码、查资料和管理文件，现在它也可以管理你的 iCloud 日历。

最近我开源了 **iCloud Calendar MCP**：一个使用 TypeScript 开发、通过 CalDAV 连接 Apple iCloud Calendar 的 MCP Server。

- GitHub： [https://github.com/IceyWu/icloud-calendar-mcp](https://github.com/IceyWu/icloud-calendar-mcp)
- npm： [https://www.npmjs.com/package/icloud-calendar-mcp](https://www.npmjs.com/package/icloud-calendar-mcp)

## 它能做什么
接入支持 MCP 的客户端后，可以直接用自然语言操作日历：
> 查询我明天的日程。
>
> 明天上午十点创建一个 30 分钟的项目讨论。
>
> 检查明天下午有没有时间冲突。
>
> 把周五的会议调整到下周一上午。

目前提供这些工具：
- 查询日历和事件
- 创建、修改和删除事件
- 检查日程冲突
- 计算忙闲时间
- 处理全天事件、时区、提醒和参与者
- 支持 RRULE 重复事件及 occurrence 查询

## 快速开始
准备好 Apple 账户邮箱和**应用专用密码**。不要使用 Apple 账户主密码。

在 MCP 客户端中添加：
```json
{
"mcpServers": {
"icloud-calendar": {
"command": "npx",
"args": ["-y", "icloud-calendar-mcp"],
"env": {
"ICLOUD_USERNAME": "you@example.com",
"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：
```bash
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](https://github.com/IceyWu/icloud-calendar-mcp)

也欢迎提交 Issue 或 PR ，一起完善 iCloud Calendar 的 MCP 使用体验。

---

原文链接：[点击查看](https://www.v2ex.com/t/1235320)

我用 TypeScript 做了一个 iCloud Calendar MCP，让 AI 真正管理你的日历

评论