Tools in this category
| Tool | Mutating | Description |
|---|---|---|
list_events |
no | List calendar event instances overlapping a UTC date range. Recurring series are expanded to individual instances. The range is optional — omit it to default to the next 30 days. |
get_event |
no | Get a single calendar event series by ID, including any per-occurrence exceptions. |
create_event |
yes | Create a new calendar event series. Provide a recurrence rule to create a recurring event; omit it for a one-off. |
update_event |
yes | Update a calendar event. scope='all' updates the whole series; 'this' edits only one occurrence (requires occurrenceStartUtc); 'following' splits the series at occurrenceStartUtc and edits forward. |
delete_event |
yes | Delete a calendar event. scope='all' deletes the whole series; 'this' skips a single occurrence (requires occurrenceStartUtc); 'following' truncates the series at occurrenceStartUtc. |
list_calendar_items |
no | List everything on the calendar between two UTC instants: calendar events (expanded recurring instances), tasks whose [startDate, deadline] span overlaps the range, and subscription renewal due-dates. Each item carries a kind discriminator. Use include to limit which kinds are returned. The range is optional — omit it to default to the next 30 days. At most 500 items are returned (sorted by date); if more match, the response is truncated with truncated: true and total reporting the full count — narrow the range or use include to see the rest. |
list_events
Mutating: no
List calendar event instances overlapping a UTC date range. Recurring series are expanded to individual instances. The range is optional — omit it to default to the next 30 days.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
rangeStart |
string | no | Optional ISO 8601 UTC range start (inclusive). Omit both bounds to default to the next 30 days from today. |
rangeEnd |
string | no | Optional ISO 8601 UTC range end (inclusive). Required together with rangeStart when either is given. |
search |
string | no | Optional case-insensitive substring filter over the title and description. |
sortOrder |
string (asc | desc) |
no | Sort direction by start time: asc (default) or desc. |
get_event
Mutating: no
Get a single calendar event series by ID, including any per-occurrence exceptions.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
seriesId |
string | yes | Calendar event series ID |
create_event
Mutating: yes
Create a new calendar event series. Provide a recurrence rule to create a recurring event; omit it for a one-off.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
title |
string | yes | Event title (max 500 chars) |
description |
string | no | Optional description (max 5000 chars) |
startUtc |
string | yes | Event start, ISO 8601 UTC |
endUtc |
string | yes | Event end, ISO 8601 UTC (must be after startUtc) |
allDay |
boolean | no | Whether the event spans whole days (default true). Set false for a timed event whose startUtc/endUtc carry a time-of-day. |
recurrence |
object | no | Optional recurrence rule. Omit for a one-off event. |
recurrenceEnd |
object | no | Optional end strategy for recurring events. Defaults to {type:'never'}. |
update_event
Mutating: yes
Update a calendar event. scope='all' updates the whole series; 'this' edits only one occurrence (requires occurrenceStartUtc); 'following' splits the series at occurrenceStartUtc and edits forward.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
seriesId |
string | yes | Calendar event series ID |
scope |
string (this | following | all) |
yes | Mutation scope: 'this' | 'all' | 'following' |
occurrenceStartUtc |
string | no | ISO 8601 UTC start of the target occurrence (required for scope 'this' or 'following'). |
title |
string | no | New title (max 500 chars) |
description |
string | no | New description, or empty string to clear |
startUtc |
string | no | New start, ISO 8601 UTC |
endUtc |
string | no | New end, ISO 8601 UTC (must be after startUtc) |
allDay |
boolean | no | Whether the event spans whole days. Set false for a timed event. |
recurrence |
object | no | Optional recurrence rule. Omit for a one-off event. |
recurrenceEnd |
object | no | Optional end strategy for recurring events. Defaults to {type:'never'}. |
delete_event
Mutating: yes
Delete a calendar event. scope='all' deletes the whole series; 'this' skips a single occurrence (requires occurrenceStartUtc); 'following' truncates the series at occurrenceStartUtc.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
seriesId |
string | yes | Calendar event series ID |
scope |
string (this | following | all) |
yes | Mutation scope: 'this' | 'all' | 'following' |
occurrenceStartUtc |
string | no | ISO 8601 UTC start of the target occurrence (required for scope 'this' or 'following'). |
list_calendar_items
Mutating: no
List everything on the calendar between two UTC instants: calendar events (expanded recurring instances), tasks whose [startDate, deadline] span overlaps the range, and subscription renewal due-dates. Each item carries a kind discriminator. Use include to limit which kinds are returned. The range is optional — omit it to default to the next 30 days. At most 500 items are returned (sorted by date); if more match, the response is truncated with truncated: true and total reporting the full count — narrow the range or use include to see the rest.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
rangeStart |
string | no | Optional ISO 8601 UTC range start (inclusive). Omit both bounds to default to the next 30 days from today. |
rangeEnd |
string | no | Optional ISO 8601 UTC range end (inclusive). Required together with rangeStart when either is given. |
include |
array | no | Subset of item kinds to include. Defaults to all: event, task, subscription_renewal. |
taskStatus |
string | no | Optional task statusId filter |
taskProjectDisplayId |
string | no | Optional task project display ID filter |
taskProjectDisplayIds |
array | no | Optional list of task project display IDs |
taskFlagged |
boolean | no | Optional flagged-only filter on tasks |
includeFinishedTasks |
boolean | no | Defaults to false |