mcpField
I
icloud-calendar

icloud-calendar

本地服务
github.com/IceyWu生产力010 周前更新
代码仓库

关于 icloud-calendar

icloud-calendar 是用于管理 Apple iCloud Calendar 的 MCP 服务，适合通过 MCP 客户端处理日历数据的用户。它提供事件操作、冲突检查和忙闲查询，并支持重复规则及时区信息。

主要功能

  1. 01列出日历和事件
  2. 02创建、查看、更新和删除事件
  3. 03检测日程冲突
  4. 04查询忙闲时段
  5. 05处理重复规则和时区信息

适用场景

  1. 01查看指定日期范围内的事件
  2. 02安排或修改日历事件
  3. 03检查预约是否重叠

MCP 相关

它通过工具向 MCP 客户端提供 iCloud Calendar 操作，包括列出日历和事件、管理事件、查找冲突及查询忙闲时段。默认使用 stdio，也支持可选的 Streamable HTTP。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "iceywu-icloud-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "icloud-calendar-mcp"
      ],
      "env": {
        "ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
        "ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>"
      }
    }
  }
}
启动命令npx -y icloud-calendar-mcp
需要配置的环境变量
ICLOUD_USERNAMEApple Account email address
ICLOUD_APP_PASSWORD密钥Apple app-specific password (never the Apple Account password)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmicloud-calendar-mcp0.1.3

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

iCloud Calendar MCP 徽标

iCloud Calendar MCP

用于管理 iCloud Calendar 的 MCP 服务。

English · 简体中文

npm 版本 npm 下载量 CI 状态 Node.js 版本 MIT 许可证

设置

要求：

  • Node.js 22.13 或更高版本
  • Apple Account 邮箱
  • Apple 专用密码

将服务添加到 MCP 客户端：

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

请使用专用密码，而非 Apple Account 密码。

工具

工具用途
list_calendars列出日历
list_events列出指定时间范围内的日程
get_event获取日程
create_event创建日程
update_event更新日程
delete_event删除日程
find_conflicts查找时间重叠的日程
free_busy返回忙碌时间范围

日程可包含时区、全天日期、重复规则、提醒、地点、描述、URL 和参与者。

请求示例

连接服务后，你可以向 MCP 客户端提出以下请求：

显示我的日历。

查看我下周按 Asia/Shanghai 时区安排的日程。

明天下午 2:00 到 3:00 在 Work 日历中添加一次项目评审，并在开始前 15 分钟提醒我。

周五上午 9:00 到中午之间有时间冲突吗？

将项目评审移到下午 4:00，并把地点改为 Meeting Room B。

在 10 月 1 日添加一个名为“Company holiday”的全天日程。

删除项目评审日程。

如果请求有歧义，请尽可能注明日历、日期、时间和时区。

行为

  • 全天日程的结束日期不包含在内。8 月 18 日的一日活动使用 2026-08-18 到 2026-08-19。
  • 创建、更新和删除操作接受 request_id，以便安全地重试。
  • 系统会通过 ETag 检测并发更改。
  • 可以更新或删除整个重复日程系列。对单次日程的不受支持的更改会返回错误，而不会修改整个系列。

完整的输入、输出和错误代码请参阅工具约定。

HTTP

stdio 是默认传输方式。Streamable HTTP 为可选方式：

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 模式需要 bearer token，且默认仅监听 loopback。通过代理公开服务前，请参阅安全。

开发

pnpm install
pnpm check

请参阅架构、贡献指南和发布。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。