PluginBench
MCP Server
Maintained
MIT

io.github.eodozzy/icloud-mcp MCP Server

io.github.eodozzy/icloud-mcp

RepositoryRegistry
How to choose

What this kind of tool is for

  • Create, search, or update items in a notes, docs, or tasks service from your agent.
  • Turn a meeting transcript or a long document into a structured summary.
  • Keep a daily log or standup digest without leaving the terminal.

How to compare servers like this

Service scope:
Confirm the tool covers the exact service and surfaces (pages, tasks, calendars) you need.
Auth model:
See whether it uses an API token you control and what permissions that token grants.
Read vs write:
Start with read-only workflows; give write access only after the first results look right.
Maintenance signal:
For anything tied to a third-party API, prefer tools that track that API's changes.

This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.

What is the io.github.eodozzy/icloud-mcp MCP server?

Read-only-by-default MCP server for iCloud mail, calendar, and contacts (IMAP/CalDAV/CardDAV).

How to install io.github.eodozzy/icloud-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • ICLOUD_USERNAME
    required

    Your Apple ID email (the IMAP/CalDAV username).

  • ICLOUD_KEYRING_SERVICE

    OS-keyring service name to read the app-specific password from. Default: icloud-mcp. Set to reuse an existing entry.

  • ICLOUD_APP_PASSWORD
    secret

    App-specific password. Fallback only; preferred storage is the OS keyring. Used only when no keyring entry is found.

  • ICLOUD_ENABLE_WRITES

    Enable mutating tools (send/reply/forward mail, create/update/delete event & contact). Off by default; each write still requires interactive confirmation. Accepts 1/true/yes/on.

  • ICLOUD_IMAP_HOST

    IMAP host override. Default: imap.mail.me.com

  • ICLOUD_IMAP_PORT

    IMAP port override. Default: 993

  • ICLOUD_SMTP_HOST

    SMTP host override (used only by write/send tools). Default: smtp.mail.me.com

  • ICLOUD_SMTP_PORT

    SMTP port override. Default: 587

  • ICLOUD_CALDAV_URL

    CalDAV base URL override. Default: https://caldav.icloud.com/

  • ICLOUD_CARDDAV_URL

    CardDAV base URL override. Default: https://contacts.icloud.com/

  • ICLOUD_TZ

    IANA timezone for rendering/scoping events. Default: system local time.

~/Library/Application Support/Claude/claude_desktop_config.json
JSON config
{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mcp"
      ],
      "env": {
        "ICLOUD_USERNAME": "<YOUR_ICLOUD_USERNAME>",
        "ICLOUD_KEYRING_SERVICE": "<YOUR_ICLOUD_KEYRING_SERVICE>",
        "ICLOUD_APP_PASSWORD": "<YOUR_ICLOUD_APP_PASSWORD>",
        "ICLOUD_ENABLE_WRITES": "<YOUR_ICLOUD_ENABLE_WRITES>",
        "ICLOUD_IMAP_HOST": "<YOUR_ICLOUD_IMAP_HOST>",
        "ICLOUD_IMAP_PORT": "<YOUR_ICLOUD_IMAP_PORT>",
        "ICLOUD_SMTP_HOST": "<YOUR_ICLOUD_SMTP_HOST>",
        "ICLOUD_SMTP_PORT": "<YOUR_ICLOUD_SMTP_PORT>",
        "ICLOUD_CALDAV_URL": "<YOUR_ICLOUD_CALDAV_URL>",
        "ICLOUD_CARDDAV_URL": "<YOUR_ICLOUD_CARDDAV_URL>",
        "ICLOUD_TZ": "<YOUR_ICLOUD_TZ>"
      }
    }
  }
}

Related MCP servers

ICiCloud logo

iCloud

Active

iCloud Mail, Calendar, Contacts, Reminders, Notes and Drive. Approval-first, self-hosted or local.

3
Python
MIT
View repository →

Collaborative document workspace with interactive AI blocks

View repository →
EZEZ@Work logo

EZ@Work

Maintained

Manage clients, projects, time, and invoices in EZ@Work — business management for freelancers.

0
Python
View repository →

Surf park sessions schedule availability and notifications for wave park surfers worldwide

Create and modify GB Studio projects with Claude using MCP tools for scenes, actors, assets, and game logic.

16
TypeScript
View repository →

Japan FTC: 361 antitrust orders and subcontract-act recommendations, with source URLs.

0
JavaScript
MIT
View repository →