calendar-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| APPLE_ID | Yes | Apple ID email. Required. | |
| CALENDAR_MCP_AUTH | No | Authentication mode. HTTP only. Defaults to none. | |
| CALENDAR_MCP_HOST | No | HTTP bind address. Defaults to 127.0.0.1. | |
| CALENDAR_MCP_PORT | No | HTTP bind port. Defaults to 18790. | |
| APPLE_APP_PASSWORD | Yes | App-specific password. Required. | |
| CALENDAR_MCP_BASE_URL | No | Public URL; becomes the OAuth issuer. Required when CALENDAR_MCP_AUTH=password. | |
| CALENDAR_MCP_PASSWORD | No | Shared password. Required when CALENDAR_MCP_AUTH=password. | |
| CALENDAR_MCP_TIMEZONE | No | IANA zone assumed when a caller omits timeZone. Defaults to host zone. | |
| CALENDAR_MCP_STATELESS | No | false restores per-client sessions. Defaults to true. | |
| CALENDAR_MCP_STATE_DIR | No | Where OAuth state is persisted. Defaults to ~/.calendar-mcp. | |
| CALENDAR_MCP_TRANSPORT | No | Transport: stdio or http. Defaults to stdio. | |
| CALENDAR_MCP_CALDAV_ROOT | No | CalDAV entry point. Defaults to https://caldav.icloud.com. | |
| CALENDAR_MCP_DEFAULT_CALENDAR | No | Calendar create_event writes to when the caller names none, by id or display name. Defaults to first writable. |
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 the user's calendars. Returns calendar IDs, names, and colors. Use this to find which calendar to add events to. Only calendars that hold events are listed; reminder lists are not part of this server's surface. |
| search_eventsA | List or search calendar events. To list a period (e.g. "what's on tomorrow"), pass only 'after'/'before' and omit 'query'. Recurring events are expanded into individual occurrences, so each occurrence has its own ID and can be updated or deleted independently. Returns full details including title, start, duration, time zone, description, locations, participants with RSVP status, and recurrence info. |
| find_free_timeA | Find open slots on the user's calendars that are long enough for something. Use this to answer "when am I free for X" or to pick a time before calling create_event. To ask what is already scheduled, use search_events instead. Openings are reported at their full length, not trimmed to 'duration', so a two-hour gap is reported as two hours even when asked for one. Not counted as busy: events marked free (TRANSP:TRANSPARENT), cancelled events, and invitations the user declined. All-day events are also not counted -- a birthday does not occupy the day -- but any that overlap the search are listed separately so they can be taken into account. |
| create_eventA | Create a calendar event. Returns the new event's id. Use update_event to change an existing event. |
| update_eventA | Update an existing calendar event. Use create_event for new events. Only specified fields are changed. For recurring events, pass an occurrence ID (from search_events) to modify just that single occurrence, or the master ID to change the whole series. |
| rsvp_eventA | Respond to a calendar event invitation. Sets your participation status and sends a reply to the organizer. For a recurring event, pass an occurrence id to respond for that occurrence alone, or the series id to respond to the whole series. |
| delete_eventA | Delete a calendar event. For recurring events, pass an occurrence id to cancel just that occurrence, or the master id to delete the entire series. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/duanefields/calendar-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server