MCP tools: calendar

Read, write, and clash-check events across every calendar over MCP. write tools need ATBRIDGE_ALLOW_WRITES=1 — see the MCP overview. To-dos are tasks.

Tool	Access	Purpose	Key parameters
`calendar_list`	read	List configured calendars	—
`calendar_refresh`	read	Re-sync refresh-capable calendars now (CalDAV/ICS)	`calendar_id`
`calendar_events_search`	read	Events in a window (lean rows by default)	`from`, `to` (YYYY-MM-DD or ISO 8601), `query`, `calendar_id`, `verbose`
`calendar_events_get`	read	One event	`id`
`calendar_clash_check`	read	Cross-calendar clash probe	`start`, `end` (YYYY-MM-DD or ISO 8601), `exclude_id`
`calendar_settings`	read	The user’s calendar settings: working hours, working days, timezone (reason about scheduling in their time)	—
`calendar_find_slots`	read	Find free slots in a window (honours events + working hours)	`from`, `to` (YYYY-MM-DD or ISO 8601), `duration_minutes`, `calendar_id`, `working_hours` (`HH:MM-HH:MM`), `limit`
`calendar_events_create`	write	Create an event	`calendar_id`, `title`, `start`, `end` (YYYY-MM-DD or ISO 8601), `location`, `description`, `attendees` (`[{email, role?}]`), `send_invites`, `recurrence` (RRULE), `until`/`count`, `force`
`calendar_events_update`	write	Patch an event	`id` + fields to change (incl. `attendees`, `send_invites`, `recurrence`); `scope` (`this`\|`all`) + `occurrence` (YYYY-MM-DD or ISO 8601) to edit one instance
`calendar_events_delete`	write	Delete an event	`id`; `scope: this` + `occurrence` (YYYY-MM-DD or ISO 8601) drops one occurrence of a series
`calendar_events_rsvp`	write	Respond to a received invite	`id`, `response` (`accepted`\|`declined`\|`tentative`), `email`

Was this page helpful?