mike-tih/icloud-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
iCloud MCPは、連絡先、カレンダー、メールへのアクセスを提供し、CalDav、CardDav、IMAPと通信します.
概要
ICloud用のモデルコンテキストプロトコルサーバー。 Claude(Desktop、Code、claude.ai Connectors)と、iCloudアカウントへのMCPクライアントのフルアクセスを与えます。 - (CalDAV):リスト/search/create/update/deleteイベント、再発イベント(RRULE)、アラート(VALARM)、IANAタイムゾーン、終日イベント、iTIP招待、Eメールでキャンセル。 - (CardDAV): ノートを含むリスト/search/get/create/update/delete; ラベル(home/work/custom)は更新を存続させます。 - (IMAP/SMTP):フォルダ、リスト、サーバサイド検索、添付ファイルを含むフルメッセージ、添付ファイルのダウンロード、送信(HTML、添付ファイル、スレッド返信)、ドラフト、移動/削除/読み込みフラグ。 MCPアノテーション(readOnlyHint, destructiveHint)をすべてのツールで実行することで、クライアントは書き込み前に確認を求めることができます。 エラーは、MCP ツールのエラーとして、アクション可能なメッセージ (例: 間違ったパスワード と 欠落している認証情報) で返されます。 - : カレンダー/連絡先/イベント ID はフル URL で、後方を渡すことができます.
概要（AI 翻訳）
ICloud用のモデルコンテキストプロトコルサーバー。 Claude(Desktop、Code、claude.ai Connectors)と、iCloudアカウントへのMCPクライアントのフルアクセスを与えます。
-Calendar(CalDAV):リスト/search/create/update/deleteイベント、イベント(RRULE)、アラート(VALARM)、IANAタイムゾーン、終日イベント、iTIPの招待状、Eメールでのキャンセル。 -Contacts(CardDAV):ノートを含むリスト/検索/作成/更新/削除;ラベル(ホーム/ワーク/カスタム)は更新を生きます。 -メール(IMAP/SMTP):フォルダ、リスト、サーバーサイド検索、添付ファイルを含むフルメッセージ、添付ファイルのダウンロード、送信(HTML、添付ファイル、スレッド返信)、ドラフト、移動/削除/読み込みフラグ。
同じコードで2つのモードで実行します。
| モード | 輸送 | 代表的な使用 | 必須 |
お問い合わせ
|ローカル(以下「オフライン」) | stdio | クロード デスクトップ / クロード コード マシンのサブプロセスとして起動 | [.env]] または環境変数 |
|Server | ストリーミング可能なHTTP、ステートレス | ドッカー / クラウドラン / 任意のホスト、多くのユーザー | リクエストヘッダーまたはHTTP基本オース、エンブフォールバック |
ツール
| ツール | 概要 | お問い合わせ
このページは 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 |
インストール
This server does not publish a one-line install command.
Open the repository installation guide MCP 初心者？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"
}
}
}
}