icloud-mcp
by epinethrone
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DATA_DIR | No | OAuth state and the outbox directory | ./data |
| MCP_HOST | No | Bind address | 0.0.0.0 |
| MCP_PORT | No | Bind port | 8000 |
| IMAP_HOST | No | IMAP server host | imap.mail.me.com |
| IMAP_PORT | No | IMAP server port | 993 |
| LOG_LEVEL | No | Log level | INFO |
| READ_ONLY | No | No sending, moving, deleting, calendar changes, or contact changes | false |
| SMTP_HOST | No | SMTP server host | smtp.mail.me.com |
| SMTP_PORT | No | SMTP server port | 587 |
| ALLOW_SEND | No | Agents can only save drafts when false | true |
| CALDAV_URL | No | CalDAV server URL | https://caldav.icloud.com |
| OUTBOX_MAX | No | Queue size | 20 |
| CARDDAV_URL | No | CardDAV server URL | https://contacts.icloud.com |
| ENABLE_MAIL | No | Enable mail area | true |
| IMAP_SECURITY | No | IMAP security mode | ssl |
| IMAP_USERNAME | No | IMAP username. Defaults to ICLOUD_USERNAME. | |
| MCP_STATELESS | No | No server-side MCP sessions, so restarting the server never breaks a connected client | true |
| SMTP_SECURITY | No | SMTP security mode | starttls |
| SMTP_USERNAME | No | SMTP username. Defaults to ICLOUD_USERNAME. | |
| MAX_BODY_CHARS | No | Result size cap for body | 30000 |
| MAX_RECIPIENTS | No | Per message | 25 |
| MCP_PUBLIC_URL | Yes | Public https address, no trailing slash | |
| SAVE_SENT_COPY | No | Append sent mail to Sent (iCloud does not do it itself) | true |
| SEND_ALLOWLIST | No | Only these addresses/domains may receive mail (@example.org,friend@example.com) | |
| CALDAV_USERNAME | No | CalDAV username. Defaults to ICLOUD_USERNAME. | |
| EMAIL_SIGNATURE | No | Plain-text signature appended to sent mail (\n = newline) | |
| ENABLE_CALENDAR | No | Enable calendar area | true |
| ENABLE_CONTACTS | No | Enable contacts area | true |
| ICLOUD_USERNAME | Yes | Apple Account you sign in with | |
| ACCESS_TOKEN_TTL | No | Access token lifetime | 3600 |
| CARDDAV_USERNAME | No | CardDAV username. Defaults to ICLOUD_USERNAME. | |
| DEFAULT_CALENDAR | No | Calendar for new events (else 'Calendar'/'Home', else the first) | auto |
| DEFAULT_TIMEZONE | No | Timezone for times without an offset | UTC |
| REFRESH_TOKEN_TTL | No | Refresh token lifetime (refresh tokens rotate) | 30 days |
| CALDAV_REQUIRE_TLS | No | Require TLS for CalDAV | true |
| MCP_OWNER_PASSWORD | Yes | Owner password (12+ chars) | |
| OUTBOX_TTL_SECONDS | No | Queue lifetime | 86400 |
| ICLOUD_APP_PASSWORD | Yes | App-specific password | |
| ICLOUD_DISPLAY_NAME | No | Sender name | |
| ICLOUD_EMAIL_ADDRESS | No | From address (your iCloud address or alias). Defaults to ICLOUD_USERNAME. | |
| MAX_ATTACHMENT_BYTES | No | Result size cap for attachments | 5 MiB |
| TOOL_TIMEOUT_SECONDS | No | A tool call running longer is abandoned with an error instead of hanging | 90 |
| ALLOW_CALENDAR_INVITES | No | Allow attendees (iCloud then emails invitations, updates, cancellations) | false |
| ALLOW_PERMANENT_DELETE | No | Allow deleting from Trash | false |
| SEND_REQUIRES_APPROVAL | No | Queue outgoing mail for browser approval | true |
| MCP_EXTRA_ALLOWED_HOSTS | No | Extra allowed Host headers | |
| OAUTH_ALLOWED_REDIRECT_HOSTS | No | Clients that may register | claude.ai,claude.com,localhost,127.0.0.1 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues