Icloud Calendar

io.github.IceyWu由 GitHub 账号 IceyWu 发布v0.1.3更新于 Oct 24, 2026

Manage Apple iCloud Calendar through a reliable CalDAV MCP server.

已验证STDIO仅桌面效率与工作流

概览

AI 生成的概览

通过 CalDAV 管理 Apple iCloud 日历的 MCP 服务器，让助理查询、创建、修改和删除日程。

可以做什么
列出所有日历，并按时间范围查询活动或获取单个活动详情。创建、更新和删除活动，支持时区、全天日期、重复规则、提醒、地点、描述、网址和参与者。查找重叠活动并返回忙碌时段，帮助安排会议。创建、更新和删除可带 request_id 以安全重试，并用 ETag 检测并发修改。
适用场景
适合希望让 AI 助理直接读取和维护 Apple iCloud 日历的用户，例如查询日程、安排会议、检查时间冲突或批量调整活动。需要本机运行 Node.js 环境，且仅支持桌面端。
运行要求
需在本机运行，Node.js 22.13 或更高版本，通过 npx 启动 icloud-calendar-mcp。需提供 Apple 账户邮箱（ICLOUD_USERNAME）和 Apple 专用密码（ICLOUD_APP_PASSWORD）。默认使用 stdio 传输，可选 HTTP 模式并需设置 bearer token。
安装前请注意
需要 Apple 账户凭据，务必使用 App 专用密码而非 Apple 账户密码，并妥善保管 ICLOUD_APP_PASSWORD。服务器可创建、修改和删除日历活动，误用可能更改或移除真实日程。重复活动仅支持整系列修改，不支持单次例外。若启用 HTTP 模式，需设置长随机 token，并在通过代理对外暴露前确认安全性。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Icloud Calendar，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[iCloud Calendar MCP logo]

iCloud Calendar MCP

An MCP server for managing iCloud Calendar.

English · 简体中文

[npm version] [npm downloads] [CI status] [Node.js version] [MIT license]

Setup

Requirements:

Add the server to your MCP client:

json
{  "mcpServers": {    "icloud-calendar": {      "command": "npx",      "args": ["-y", "icloud-calendar-mcp"],      "env": {        "ICLOUD_USERNAME": "[email protected]",        "ICLOUD_APP_PASSWORD": "xxxx-xxxx-xxxx-xxxx"      }    }  }}

Use an app-specific password, not your Apple Account password.

Tools

ToolPurpose
list_calendarsList calendars
list_eventsList events in a time range
get_eventGet an event
create_eventCreate an event
update_eventUpdate an event
delete_eventDelete an event
find_conflictsFind overlapping events
free_busyReturn busy time ranges

Events can include time zones, all-day dates, recurrence rules, alarms, locations, descriptions, URLs, and attendees.

Example requests

Once the server is connected, you can ask your MCP client:

Show my calendars.

What is on my calendar next week in Asia/Shanghai time?

Add a project review to my Work calendar tomorrow from 2:00 PM to 3:00 PM, with a reminder 15 minutes before.

Do I have any conflicts on Friday between 9:00 AM and noon?

Move the project review to 4:00 PM and change the location to Meeting Room B.

Add an all-day event called “Company holiday” on October 1.

Delete the project review event.

For ambiguous requests, include the calendar, date, time, and time zone when possible.

Behavior

  • All-day event end dates are exclusive. A one-day event on August 18 uses 2026-08-18 to 2026-08-19.
  • Create, update, and delete operations accept a request_id for safe retries.
  • Concurrent changes are detected with ETags.
  • Whole recurring series can be updated or deleted. Unsupported occurrence-level changes return an error instead of modifying the series.

See tool contracts for complete inputs, outputs, and error codes.

HTTP

stdio is the default transport. Streamable HTTP is optional:

bash
ICLOUD_MCP_TRANSPORT=http \ICLOUD_MCP_HTTP_TOKEN='replace-with-a-long-random-token' \ICLOUD_MCP_HTTP_PORT=3000 \npx -y icloud-calendar-mcp

HTTP mode requires a bearer token and listens on loopback by default. See security before exposing it through a proxy.

Development

bash
pnpm installpnpm check

See architecture, contributing, and releasing.

License

MIT

来源：README.md，提交 06dc175

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分