mike-tih/icloud-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

13 stars 24 forks 质量 84 趋势 40MIT

Repository Install

iCloud MCP与应用特定符号合作,提供访问联系人,日历和邮件,与CalDav,CardDav和IMAP通信.

概览

ICloud 的模拟上下文协议服务器。让克洛德(Desktop, Code, claude.ai)和任何其他MCP客户端完全访问iCloud账户: - (CalDAV):列表/搜索/创建/更新/删除事件,经常性事件(RRULE),提醒(VALARM),IANA时区,全天活动,iTIP邀请和电子邮件取消. - (CDDAV):列表/搜索/get/创建/更新/删除,包括注释;标签(家庭/工作/习惯)幸存更新. -(IMAP/SMTP):文件夹,列表,服务器侧搜索,带有附件的完整消息,附件下载,发送(HTML,附件,线程回复),草稿,移动/删除/读取旗帜. 每个工具都带有MCP注释(read OnlyHint,破坏性Hint),因此客户端可以在写作前请求确认. 出错作为带有可操作信件的MCP工具出错返回(例如错误的密码与缺失的证书). - 日历/接触/事件ID是完整的URL,逐字递回.

概述（AI 翻译）

ICloud 的模拟上下文协议服务器。让克洛德(Desktop, Code, claude.ai)和任何其他MCP客户端完全访问iCloud账户:

** Calendar**(CalDAV):列表/搜索/创建/更新/删除事件、经常性事件(RRULE)、警报(VALARM)、IANA时区、全天活动、iTIP邀请和电子邮件取消。
** 联系**(CDDAV):列表/搜索/get/创建/更新/删除,包括注释;标签(家庭/工作/海关)存续更新。
Mail(IMAP/SMTP):文件夹,列表,服务器侧搜索,带有附件的完整信件,附件下载,发送(HTML,附件,有线性回复),草稿,移动/删除/读取旗帜.

以两种模式运行,代码相同:

□ 工具

工具 * * 描述 * * |-|-|-

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

iCloud MCP Server

Model Context Protocol server for iCloud. Gives Claude (Desktop, Code, claude.ai connectors) and any other MCP client full access to an iCloud account:

Calendar (CalDAV): list/search/create/update/delete events, recurring events (RRULE), alerts (VALARM), IANA timezones, all-day events, iTIP invitations and cancellations by email.
Contacts (CardDAV): list/search/get/create/update/delete, including notes; labels (home/work/custom) survive updates.
Mail (IMAP/SMTP): folders, listing, server-side search, full messages with attachments, attachment download, sending (HTML, attachments, threaded replies), drafts, move/delete/read flags.

Runs in two modes with the same code:

Mode	Transport	Typical use	Credentials
Local (“offline”)	stdio	Claude Desktop / Claude Code launch it as a subprocess on your machine	`.env` or environment variables
Server	Streamable HTTP, stateless	Docker / Cloud Run / any host, many users	Per-request headers or HTTP Basic auth, env fallback

Tools

Tool	Description
`calendar_list_calendars`	Calendars with IDs; Reminders lists are flagged `read_only`
`calendar_list_events`	Events in a date range, recurring series expanded per occurrence, sorted by start
`calendar_list_subscriptions`	Subscribed (webcal/ICS) calendars with IDs and feed host (never the feed URL)
`calendar_list_subscribed_events`	Events from subscribed calendars, fetched from their feeds; failures reported in `feed_errors`
`calendar_search_events`	Text search over summary/description/location
`calendar_create_event`	Create an event: timezone, all-day, `rrule`, `reminders` (minutes before start or `"09:00"` time of day), attendees (invitations sent by email)
`calendar_update_event`	Partial update; change timezone/recurrence/alerts; re-sends invitations when attendees change
`calendar_delete_event`	Delete and email cancellations to attendees
`contacts_list` / `contacts_search` / `contacts_get`	Read contacts (name, phones, emails, addresses, organization, title, notes)
`contacts_create` / `contacts_update` / `contacts_delete`	Write contacts
`email_list_folders`	Folders with IMAP flags
`email_list_messages`	Newest messages of a folder with readable `body_text`, `unread`, `has_attachments`
`email_search`	Server-side IMAP search: `query`, `sender`, `recipient`, `subject`, `body`, `since`, `before`, `unread_only` (AND)
`email_get_message` / `email_get_messages`	Full message(s): headers, `body_text`, optional raw `body_html`, attachment list
`email_get_attachment`	Download an attachment: save to a local directory (stdio) or return it inline

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "icloud": {
      "command": "/absolute/path/to/icloud-mcp/.venv/bin/icloud-mcp",
      "env": {
        "ICLOUD_EMAIL": "[email protected]",
        "ICLOUD_APP_SPECIFIC_PASSWORD": "xxxx-xxxx-xxxx-xxxx",
        "DEFAULT_TIMEZONE": "Europe/Berlin"
      }
    }
  }
}