Skip to main content
Glama
InstaCode

icloud-calendar-mcp-server

by InstaCode
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ICLOUD_USERNAMEYesYour iCloud email address
ICLOUD_APP_PASSWORDYesApp-specific password generated from Apple ID

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

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
icloud_list_calendarsA

List all calendars in the authenticated iCloud account.

Returns each calendar's display name, URL (used as a stable identifier), color, and timezone if available.

Use this when:

  • The user asks "what calendars do I have"

  • You need a calendar identifier to pass to other tools

  • Disambiguating between calendars with similar names

icloud_list_eventsA

List events from a specific calendar within a time range.

Args:

  • calendar: Display name (e.g. "Work") or full CalDAV URL

  • start: ISO 8601 datetime for range start

  • end: ISO 8601 datetime for range end

Returns an array of events with uid, summary, start, end, location, description, allDay flag. The 'uid' is the stable identifier — use it for update/delete operations.

icloud_create_eventA

Create a new event on the specified calendar.

Args:

  • calendar: Display name or full CalDAV URL

  • summary: Event title (required)

  • start, end: ISO 8601 datetimes

  • description, location: optional

  • allDay: boolean (default false)

Returns the created event's uid and CalDAV URL.

icloud_update_eventA

Update fields on an existing event by UID.

Args:

  • calendar: Display name or full CalDAV URL where the event lives

  • uid: Event UID (from icloud_list_events)

  • Any of: summary, description, location, start, end, allDay (only provided fields are updated)

Returns confirmation with the updated UID.

icloud_delete_eventA

Delete an event by UID.

Args:

  • calendar: Display name or full CalDAV URL

  • uid: Event UID

This is destructive. Confirm with the user before invoking.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.2/5.0

Scored across 5 tools

Disambiguation5/5

Each tool targets a distinct operation: creating, deleting, listing calendars, listing events, and updating events. No overlap in functionality.

Naming Consistency5/5

All tools follow the 'icloud_verb_noun' pattern using lowercase with underscores, ensuring clear and predictable naming.

Tool Count5/5

With 5 tools, the set covers essential CRUD operations for calendar events plus calendar listing, which is appropriate for a focused calendar server.

Completeness4/5

Core operations (create, read, update, delete) are present, but a direct 'get event by UID' tool is missing, requiring agents to list events and filter. This is a minor gap.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources