mike-tih/icloud-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

13 stars 24 forks 품질 84 트렌드 40MIT

Repository Install

앱 특정 토큰으로 작동하는 iCloud MCP는 연락처, 캘린더 및 메일, CalDav, CardDav 및 IMAP와 통신 할 수있는 액세스를 제공합니다.

개요

ICloud 용 모델 Context Protocol 서버. Claude (Desktop, Code, claude.ai 커넥터) 및 iCloud 계정에 다른 MCP 클라이언트 전체 액세스 제공 : - (CalDAV): list/search/create/update/delete event, recurring event (RRULE), alerts (VALARM), IANA timezones, 올데이 이벤트, iTIP 초대장 및 취소 이메일. - (CardDAV) : 노트를 포함하여 목록 / 연구 / 태그 / 생성 / 업데이트 / 삭제; 라벨 (홈 / 워크 / 사용자 정의)는 업데이트를 살아. - (IMAP / SMTP) : 폴더, 목록, 서버 측 검색, 첨부 파일이있는 전체 메시지, 첨부 파일 다운로드, 전송 (HTML, 첨부 파일, 스레드 응답), 초안, 이동 / 삭제 / 읽는 플래그. 모든 도구는 MCP annotations (readOnlyHint, destructiveHint)를 수행하므로 클라이언트는 쓰기 전에 확인을 요청할 수 있습니다. 오류가 MCP 도구 오류로 반환됩니다. actionable 메시지 (예 : 잘못된 암호 vs. 누락 된 자격). - : 달력/contact/event ID는 전체 URL이며, 동사역을 통과합니다.

개요(AI 번역)

ICloud 용 모델 Context Protocol 서버. Claude (Desktop, Code, claude.ai 커넥터) 및 iCloud 계정에 다른 MCP 클라이언트 전체 액세스 제공 :

Calendar (CalDAV): list/search/create/update/delete event, recurring event (RRULE), alert(VALARM), IANA timezones, all-day event, iTIP 초대장 및 취소 이메일. -Contacts (CardDAV): 노트를 포함하여 목록/검색/쓰기/업데이트/드렛; 상표 (home/work/custom) 살아 있는 갱신. -Mail (IMAP/SMTP): 폴더, 목록, 서버 측 검색, 첨부 파일이있는 전체 메시지, 첨부 파일 다운로드, 전송 (HTML, 첨부 파일, 스레드 답글), 초안, 이동/드렛/레드 플래그.

같은 코드와 두 가지 모드에서 실행:

모드	교통	전형 사용	Credentials
Local (“offline”)	stdio	Claude Desktop / Claude Code가 기계에 하위 공정으로 출시되었습니다	`.env` 또는 환경 변수
Server	Streamable HTTP, stateless	Docker / Cloud Run / 모든 호스트, 많은 사용자	Per-request 헤더 또는 HTTP Basic auth, env fallback

도구

도구	설명

이 페이지는 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 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"
      }
    }
  }
}