mcp-icloud

iCloud access for your AI tools

Bring your Apple world into the conversation.

Connect Claude to the iCloud services you already rely on, then ask for help in plain language.

Add this server as a custom connector in Claude, then start using Claude normally. Apple sign-in only happens the first time a tool actually needs iCloud access.

Set up the Claude connector

This is the main setup flow. Add the custom connector in Claude, then wait to sign in to iCloud until you actually use one of the tools.

How it works

1
Add a custom connector

Open Claude's connector modal, then paste in the name and MCP URL below.

2
Keep using Claude normally

Ask for what you need in plain language, just like any other Claude workflow.

3
Sign in on first use

If a tool needs iCloud access, Claude will send you to Apple sign-in and verification.

Connector details

Use this suggested name and MCP URL when Claude asks for the connector details.

iCloud
https://icloud.mcp.jflamb.com/mcp
Add Connector to Claude
Important: adding the connector does not ask for your Apple credentials yet. You will be prompted to sign in to iCloud the first time you invoke one of the server's tools.

Use it together, not one surface at a time.

The value here is not just individual iCloud endpoints. It is being able to pull together schedules, files, contacts, notes, reminders, photos, and account context in one conversation.

Plan the week across calendars and reminders.

Use one prompt to understand time commitments, unfinished tasks, and conflicts before they become a mess.

What do I have on my calendar tomorrow, and which reminders are due the same day?
Show me the most important reminders due this week and match them to open time on my calendar.
List my upcoming events for the next seven days and flag anything that overlaps with travel prep tasks.

Find the right thing across photos, notes, and Drive.

Use context from multiple iCloud surfaces to track down what you meant, not just what you typed exactly.

Find the photo I took at the beach last summer and tell me which album it is in.
Show the notes I edited most recently about our kitchen remodel and any files nearby in Drive that look related.
Pull up the receipt PDF I saved in iCloud Drive and give me the file path.

Coordinate people, plans, and follow-through.

Bring together contact details, groups, schedules, and tasks when you are trying to get something done with other people.

Create a contact group for family travel planning.
Show my upcoming calendar events with Sam and the reminders I still need to finish before those meetings.
Find the contacts I use most for school pickup and group them together.

Get quick personal operating context.

Sometimes you just want a reliable snapshot of what is in your account, what changed, or what needs attention.

Summarize my iCloud storage and tell me what is using the most space.
List the files added to my Documents folder this week.
Show me the current status of the connector and whether I need to reauthenticate.

Server status and project fit.

A concise view of what this server is, how it is configured right now, and how this repository is intended to be used.

Health Operational Runtime uptime: 0m
Cloud Run service mcp-icloud
mcp-icloud-00034-vaz
Version 0.1.0 Repository package version from src/mcp_icloud/__init__.py.
MCP endpoint https://icloud.mcp.jflamb.com/mcp Primary remote endpoint for Claude custom connector setup.

This repository is meant to be forked, configured, and deployed on infrastructure you control for your own personal use. The current hosted instance is a reference deployment, not a shared multi-tenant product. If you want to run your own version, start from the code and deployment scaffolding in the GitHub repository.

View GitHub repo Status JSON Operator view