Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

icloud-mcp

by ThomasCrouzetversion 1.1.1i★ 7iRuns on your computerRepository ↗
Registry nameio.github.ThomasCrouzet/icloud-mcp

How to install

What it does

stdio MCP for iCloud Calendar (CalDAV), with optional Contacts and Mail.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Docs, sheets & office work

Use together with

Skills that teach the AI this kind of work; they work alongside this one

MinerU

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

by opendatalab★ 83,9191 skills

Skill · How-to guideNo license stated

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

by guillaumemeyer★ 27,7231 skills

Skill · How-to guide

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

by kepano★ 53,104 (whole repo)5 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity11/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score23/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Passed 3/3 checks · Runs on your computer

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

  1. Download the maker’s installer

    Download the maker’s .mcpb file

    The .mcpb file comes straight from the maker; we do not change it

  2. Double-click the file, then click Install in the Claude desktop app

  3. Try it

    Use icloud-mcp and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using icloud-mcp or shows a icloud-mcp tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect icloud-mcp yet

icloud-mcp runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect icloud-mcp

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

B · Others in Docs, sheets & office work that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Claude Code cannot connect icloud-mcp yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect icloud-mcp

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Cursor cannot connect icloud-mcp yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect icloud-mcp

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

VS Code cannot connect icloud-mcp yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect icloud-mcp

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use icloud-mcp💬 Discussion →

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs on your computer
Latest versioni
1.1.1
Published to registryi
Nov 16, 2026
Code last changedi
Nov 16, 2026
Maker
ThomasCrouzet
Packages
mcpb: …/icloud-mcp-v1.1.1-linux-amd64.mcpb
mcpb: …/icloud-mcp-v1.1.1-linux-arm64.mcpb
mcpb: …/icloud-mcp-v1.1.1-darwin-arm64.mcpb
Website
github.com
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account ThomasCrouzet, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 3 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked: only npm and PyPI packages with a version can be checked

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/thomascrouzet-icloud-mcp.svg)](https://mcp.popnx.com/en/servers/thomascrouzet-icloud-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Docs, sheets & office worki

  • More stars than 93% of the other 4126 servers in this category
  • Published to the registry more recently than 89% of the other 4126 servers in this category
  • Basic checks equal to or better than 99% of the other 4126 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is icloud-mcp safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 3 days ago, and the latest version (1.1.1) reached the registry 3 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need MCPB on your computer.

What can I use instead?

In the same category: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

by HeyPuterWidely used★ 44.2KUpdated 5 months ago

Runs in the cloud✓ service owner · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

by getsentryWidely used↓ 130.5K/wk shared package★ 6.6KUpdated 4 months ago

Runs on your computer✓ service owner · xcodebuildmcp.com

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

by Vexa-aiWidely used★ 3KUpdated 2 months ago

Runs in the cloud✓ service owner · vexa.ai

Atlassian Rovo MCP Server

Atlassian’s official server lets AI search and manage Jira work and Confluence pages. Connects to Atlassian’s cloud with OAuth sign-in.

by atlassianGrowing★ 1.2KUpdated 2 months ago

Runs in the cloud✓ service owner · atlassian.com

Anki MCP Server

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

by ankimcpGrowing↓ 1.1K/wk★ 567Updated last month

Runs on your computer✓ service owner · ankimcp.ai
Compared with similar ones
This one
icloud-mcp
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
Runs whereInstalls on your computerRuns in the cloud, nothing to installInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installInstalls on your computer
Needs a keyNoNoNoYesNoNo
Add with + in ClaudeNoNoNoNoYesNo
Basic checks3/34/43/32/44/43/3
LicenseMITAGPL-3.0MITApache-2.0Apache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

icloud-mcp

iCloud Calendar, Contacts, and Mail through one stdio MCP server.

Get started | MCP tools | Configuration | Documentation

Connect an MCP host to iCloud with one Go binary. Calendar uses CalDAV; optional Contacts and Mail use CardDAV, IMAP, and SMTP. The host starts the process and exchanges JSON-RPC through stdin and stdout.

Why icloud-mcp?

Use this server when an MCP host needs to search calendars, find free time, or work with iCloud contacts and messages on a headless machine. It uses app-specific passwords and remote protocols, without macOS frameworks, browser automation, or private Apple APIs.

Capability gates let you start with Calendar reads and enable other operations as needed. Each domain has its own protocol clients and network policy. All enabled domains share one process: a process compromise can expose all loaded credentials. Use separate processes and account configurations for stronger isolation.

Privacy and security

Accounts: An Apple Account with iCloud Calendar and an app-specific password is required. Contacts uses the same identity. Optional Mail needs a full iCloud Mail address and can use a separate app-specific password. The server has no separate product account; the MCP host has its own account requirements.

Telemetry: The server has no telemetry or crash-reporting service. It writes operational logs and mutation audit records to stderr. The host controls log retention and has its own telemetry policy.

Data: Credentials are loaded at startup. Discovery state and keyed update results stay in process memory; the server writes no local data files. It sends authenticated requests to iCloud and returns account content to the MCP host. That host controls any further storage or transmission to a model provider.

  • Fixed destinations. Calendar and Contacts use their iCloud hosts and validated shards on port 443. Mail uses imap.mail.me.com:993 and smtp.mail.me.com:587, with mandatory STARTTLS for SMTP. TLS 1.2 or later is required. DAV ignores proxy environment variables.
  • Redaction and audit. The server redacts configured identities, passwords, and Basic/SASL forms from errors, results, and logs. Mutation audits contain domain, resourceType, and a process-local HMAC resourceToken, without raw resource paths, UIDs, mailboxes, or recipients.
  • Host permissions. Remote text can contain prompt injection. A compromised host model can invoke every registered tool. Start with global read-only mode and enable only the capabilities you need.

See the threat model and reporting policy and security implementation.

Capability gates

CapabilityOperationsEnablement
CalendarList calendars; search, get, and validate events; find free slots; create, update, and delete eventsReads always on; calendar.write and calendar.delete in ICLOUD_MCP_PERMISSIONS are required for effects; group-scheduled mutations also need calendar.schedule and acknowledge_scheduling
ContactsList books; search and get contacts; create, update, and delete vCard 3.0 contactsReads require ICLOUD_MCP_ENABLE_CONTACTS=true; writes require contacts.write or contacts.delete
Mail readList mailboxes; search messages; get plain text and attachment metadataICLOUD_MCP_ENABLE_MAIL=true
Mail mutationChange flags; move or trash a messageMail plus mail.mutate or mail.trash
Mail sendSubmit a plain-text message, or reply to one with preserved conversation headers, through SMTPMail plus mail.send and a recipient policy

ICLOUD_MCP_READ_ONLY=true removes every mutation and send tool from tools/list. It does not enable a disabled read domain. Contacts has no separate write flag. Mail mutation and send have independent gates. A send policy is required whenever the send flag is set, including under global read-only.

ICLOUD_MCP_RESOURCE_SCOPES optionally limits which calendars, address books, and mailboxes an agent may use. It is a semicolon-separated list of action=value[,value] entries. Actions are calendar.read, calendar.write, calendar.delete, contacts.read, contacts.write, contacts.delete, mail.read, mail.mutate, and mail.archive. A literal * keeps an action unrestricted.

Calendar values are paths. Contacts values are opaque identifiers or exact display names. Mail values are exact mailbox names. Omitted action scopes fall back to the read or write scope for that domain. Direct identifier injection is checked before the domain operation. Ambiguous or stale Contacts names fail closed. The variable is invalid if an action is unknown, duplicated, empty, or a Calendar path is malformed.

ICLOUD_MCP_PERMISSIONS names every capability. It takes a comma-separated list: calendar.read, calendar.write, calendar.delete, calendar.schedule, contacts.read, contacts.write, contacts.delete, mail.read, mail.mutate, mail.trash, mail.send, and mail.archive. calendar.schedule is a separate operator grant for group-scheduled Calendar mutations and requires calendar.write or calendar.delete. Domain switches still enable a domain. Global read-only still removes every mutation and send. With no value, enabled domains are read-only. No switch, flag, or omission implies an effect. For example, calendar.read,mail.read,mail.send gives Calendar reads and Mail send without Calendar, Contacts, or Mail mutation tools.

MCP tools

The server registers 7 tools with the default read-only profile, including the global capability tool, and 24 when explicit permissions and domain gates enable every capability. Disabled tools are absent from discovery. The MCP interface provides tools over stdio.

ToolInputResultAccount changes
icloud_capabilitiesNo argumentsEnabled domains, effective capabilities, version, tool names and countNone; the call uses local state
list_calendarsNo argumentsCalendar names and paths for subsequent callsNone
search_eventsstart, end; optional calendar, filters, and cursorSorted event page with calendar, recurrence occurrences, truncation or failure warnings, and optional nextCursorNone
update_eventcalendar, uid, changed fields; optional etag, idempotency_key, occurrence scopeUpdated event or a structured errorConditional Calendar write
get_messagemailbox, uid_validity, uid; optional body limit and HTML fallbackMessage metadata and bounded plain textNone; EXAMINE and PEEK preserve read state
send_messagebody, optional subject, idempotency_key, and at least one recipient across to, cc, bccSubmission status or a structured errorSends mail to allowed recipients; identical keyed calls reuse one submission
reply_messagesource mailbox, uid_validity, uid; body; optional mode and idempotency_keySubmission status or a structured errorReplies to the resolved sender or reply-all recipients; never marks Answered or appends Sent

The complete inventory lists all tools. Run icloud-mcp -doctor for authenticated read-only network checks. Add -doctor-format=json for machine-readable output. The command validates local configuration, then probes enabled domains with a 10-second timeout each. It never creates, updates, moves, trashes, or sends. Exit status is 0 when every enabled domain is ready and 1 when a probe fails. Disabled domains stay disabled; enabled domains are never reported ready before a successful probe.

-doctor is not an offline profile check. It discovers collections and mailboxes outside MCP resource filtering, and it does not probe SMTP. See the diagnostic authorization limits. It is not available in v0.4.3. For credential-free TLS checks and hosted-network limitations, see Mail network troubleshooting.

Representative read tools also publish output schemas and structuredContent. Their text content remains for older hosts. Both forms come from the same redacted values. Discover their argument schemas with the host's tool list. Domain failures set the MCP error flag and include a JSON code in text content. Follow the error and recovery reference.

Get started

This first run gives an MCP host read-only Calendar access. You need an MCP host, network access to iCloud, and an Apple Account with two-factor authentication to create an app-specific password. Never use the main Apple Account password.

Read-only by default. With no ICLOUD_MCP_PERMISSIONS, the server exposes reads only. Keep ICLOUD_MCP_READ_ONLY=true for the first run. No switch or omission grants an effect.

Choose an install path
PathUse whenInstallation evidence
MCPB bundle (recommended)Your host installs MCPB files and you do not want GoBundle build, manifest validation, native startup, and signatures are verified. Real host installation is UNVERIFIED (#126).
Release archiveLinux amd64/arm64 or macOS arm64, with a manual host commandNative archive smoke is verified on the matching platform. Host configuration is manual.
`go install`You develop with Go 1.26.0 or newerBuild, tests, and protocol checks are verified locally and in CI.

The MCPB path is first because it needs no compiler. The missing evidence is a recorded install in a named host version, not a bundle defect. Until that record exists, this page does not claim that an MCPB host install was performed.

Path A: MCPB bundle (host installation unverified)
  1. Download the bundle for your platform from the v1.1.1 release: linux-amd64, linux-arm64, or darwin-arm64.
  2. Download icloud-mcp-v1.1.1-checksums.txt and the matching .sig and .pem files. Verify the bytes:
   shasum -a 256 -c icloud-mcp-v1.1.1-checksums.txt

cosign verify-blob \ --certificate icloud-mcp-v1.1.1-linux-amd64.mcpb.pem \ --signature icloud-mcp-v1.1.1-linux-amd64.mcpb.sig \ --certificate-identity "https://github.com/ThomasCrouzet/icloud-mcp/.github/workflows/ci.yml@refs/tags/v1.1.1" \ --certificate-oidc-issuer "https://token.actions.githubusercontent.com" \ icloud-mcp-v1.1.1-linux-amd64.mcpb

  1. Open the .mcpb file in your MCPB-capable host, or use that host's install command. The host reads manifest.json, asks for the declared user settings, and starts ${__dirname}/server/icloud-mcp.
  2. Set email and the app-specific password. Keep read_only=true, permissions=calendar.read, enable_contacts=false, and enable_mail=false. Set your IANA

Only the beginning is shown; read the rest in the repo