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 分