ical-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ICAL_MCP_URL | Yes | CalDAV server URL (e.g. https://caldav.icloud.com) | |
| ICAL_MCP_PASSWORD | Yes | Password or app-specific password | |
| ICAL_MCP_TIMEZONE | No | Default timezone (default: UTC) | UTC |
| ICAL_MCP_USERNAME | Yes | Your email / account ID | |
| ICAL_MCP_WRITABLE_CALENDARS | No | Calendars that allow writes (see Write protection) |
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_calendarsA | List all available calendars. Returns calendar names and IDs for use with other tools. Call this first to discover which calendars exist before querying or creating events. |
| get_eventsA | Get events within a date range. Returns events sorted by start time. Recurring events are returned as individual expanded occurrences within the requested range. |
| create_eventA | Create a new calendar event. Confirm the calendar, date, time, and details with the user before calling. Returns the created event with its ID and ETag for future updates. |
| update_eventA | Update an existing calendar event. Only send the fields you want to change — unchanged fields are preserved. Requires the event's ETag for optimistic concurrency; if the event was modified elsewhere, the update will fail with a conflict error. |
| delete_eventA | Delete a calendar event. Confirm with the user before deleting. Pass the ETag from get_events to ensure you're deleting the right version. |
| get_freebusyA | Check free/busy status for a time range. Returns a list of busy time blocks within the requested range. Useful for finding available slots before scheduling. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a clear, distinct purpose: create, delete, get, update events, plus free/busy and list calendars. No overlap or ambiguity.
All tools use a consistent verb_noun pattern in snake_case (e.g., create_event, list_calendars). No deviations or mixed conventions.
With 6 tools, the set is well-scoped for a calendar MCP server: covers CRUD for events and essential utilities without being bloated or sparse.
Covers core calendar operations (CRUD events, free/busy, list calendars). Minor gap: lacks advanced event search (e.g., by title) but handles typical workflows well.