Timed, all-day and repeating calendar events, guests and responses, reminders, and iCalendar import and export.
A calendar is a resource with kind calendar. An event stores its start (a date, or a wall time in its IANA timezone) and duration, so a weekly 9:00 event stays at 9:00 across daylight saving changes.
A repeating series is stored as one event with an RRULE in recurrence. It occurs at most once a day, so each occurrence is identified by its date (event_id:day in calendar_list_events). Changing or deleting one occurrence (apply_to: this) stores only that day’s changes, so later changes to the series still apply to the rest.
Guests must have access to the calendar (see list_people). Invited guests are notified as if mentioned. They respond with calendar_respond_to_event.
The examples use the callTool helper. To connect, see the Quickstart or Authentication.
Calendars
A limited agent can make only the changes its permissions allow. Read-only access allows no changes. See Access and permissions.
| Calendar | Allows |
|---|---|
create | Add events. |
edit_own | Change and delete the agent’s own events, occurrences and guests. |
edit_any | Change and delete any event. |
settings | Change the calendar’s color, time zone and week start. |
Calendars
These limits apply alongside the general limits.
| What | Limit |
|---|---|
| Titles | 200 characters |
| Locations | 500 characters |
| Descriptions | 10,000 characters |
| Events | Up to 366 days long |
| Guests | 100 per event |
| Reminders | 5 per event, up to four weeks before the start |
calendar_list_events | 366 days and 1,000 occurrences per call |
calendar_import_events | 2 MB and 2,000 events per file |
Tools · Calendars
Returns a calendar’s settings, events and changes to individual occurrences. Each event is listed once, regardless of recurrence. For the occurrences in a date range, use calendar_list_events.
project_id string Requiredspace_id string Requiredlist_spaces.An object with settings, events and exceptions. settings includes color, timezone and week_start (0 for Sunday to 6 for Saturday). Each event has start (a date for all-day events, otherwise a wall time in timezone), duration (days or minutes), link (a call link, or empty), recurrence (an RRULE, or null), reminders (comma-separated minutes before the start), created_by and guests. Each guest has a response (yes, no, maybe or null). Each exception identifies its event and occurrence day, with only the changed fields in changes. cancelled marks a deleted occurrence.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calendar_get",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "c4a1f0e2b7d94e6a8f3b2c1d0e9f8a7b"
}
}
}'{
"settings": {
"color": "peacock",
"timezone": "America/New_York",
"week_start": 1
},
"events": [
{
"title": "Standup",
"location": "Room 4",
"link": "https://meet.example.com/standup",
"all_day": false,
"start": "2026-10-05T09:30",
"duration": 15,
"timezone": "America/New_York",
"color": null,
"recurrence": "FREQ=WEEKLY;BYDAY=MO,WE,FR",
"free": false,
"reminders": "10",
"description": "",
"id": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"created_by": "9735814189d64dd5dc193fe843b45992",
"created_at": "2026-09-30T23:46:04.480Z",
"updated_at": "2026-09-30T23:46:04.480Z",
"guests": [
{
"id": "b8bc98d760d80b652c1b714e88c31882",
"response": "yes"
}
]
},
{
"title": "Launch day",
"location": "",
"link": "",
"all_day": true,
"start": "2026-10-21",
"duration": 1,
"timezone": null,
"color": "tomato",
"recurrence": null,
"free": true,
"reminders": "",
"description": "Ship it.",
"id": "9b8a7c6d5e4f40312a1b0c9d8e7f6a5b",
"created_by": "5761e31cd8538b7da8a3ddd4157bd632",
"created_at": "2026-09-30T23:46:04.490Z",
"updated_at": "2026-09-30T23:46:04.490Z",
"guests": []
}
],
"exceptions": [
{
"id": "0d9c8b7a6f5e44d3c2b1a09f8e7d6c5b",
"event_id": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"day": "2026-10-16",
"cancelled": false,
"changes": {
"start": "2026-10-16T11:00"
},
"created_at": "2026-09-30T23:46:04.495Z",
"updated_at": "2026-09-30T23:46:04.495Z"
}
]
}Tools · Calendars
Lists a calendar’s occurrences between two dates or times, in order, listing each occurrence of a repeating event separately. Defaults to the next 30 days.
project_id string Requiredspace_id string Requiredlist_spaces.start string YYYY-MM-DD, from midnight) or time (YYYY-MM-DDTHH:MM). Defaults to today.end string start. Defaults to 30 days after start.timezone string start and end, such as Europe/Paris. Defaults to the calendar’s time zone, or UTC if it has none.query string An object with time_zone, events (at most 1,000) and more (true if the list was truncated). Each event has id (the event’s id, or event_id:day for an occurrence of a repeating event), start and end in the same form as the event’s own start (an all-day end is the last day), and the instants starts_at and ends_at.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calendar_list_events",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "c4a1f0e2b7d94e6a8f3b2c1d0e9f8a7b",
"start": "2026-10-12",
"end": "2026-10-16"
}
}
}'{
"time_zone": "America/New_York",
"events": [
{
"id": "5e2d8c7b1a094f3e86d7c5b4a3928170:2026-10-12",
"event_id": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"day": "2026-10-12",
"exception_id": null,
"recurring": true,
"recurrence": "FREQ=WEEKLY;BYDAY=MO,WE,FR",
"title": "Standup",
"description": "",
"location": "Room 4",
"link": "https://meet.example.com/standup",
"all_day": false,
"start": "2026-10-12T09:30",
"end": "2026-10-12T09:45",
"duration": 15,
"timezone": "America/New_York",
"color": null,
"free": false,
"reminders": [
10
],
"guests": [
{
"id": "b8bc98d760d80b652c1b714e88c31882",
"response": "yes"
}
],
"created_by": "9735814189d64dd5dc193fe843b45992",
"starts_at": "2026-10-12T13:30:00.000Z",
"ends_at": "2026-10-12T13:45:00.000Z"
},
{
"id": "5e2d8c7b1a094f3e86d7c5b4a3928170:2026-10-14",
"event_id": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"day": "2026-10-14",
"exception_id": null,
"recurring": true,
"recurrence": "FREQ=WEEKLY;BYDAY=MO,WE,FR",
"title": "Standup",
"description": "",
"location": "Room 4",
"link": "https://meet.example.com/standup",
"all_day": false,
"start": "2026-10-14T09:30",
"end": "2026-10-14T09:45",
"duration": 15,
"timezone": "America/New_York",
"color": null,
"free": false,
"reminders": [
10
],
"guests": [
{
"id": "b8bc98d760d80b652c1b714e88c31882",
"response": "yes"
}
],
"created_by": "9735814189d64dd5dc193fe843b45992",
"starts_at": "2026-10-14T13:30:00.000Z",
"ends_at": "2026-10-14T13:45:00.000Z"
},
{
"id": "5e2d8c7b1a094f3e86d7c5b4a3928170:2026-10-16",
"event_id": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"day": "2026-10-16",
"exception_id": "0d9c8b7a6f5e44d3c2b1a09f8e7d6c5b",
"recurring": true,
"recurrence": "FREQ=WEEKLY;BYDAY=MO,WE,FR",
"title": "Standup",
"description": "",
"location": "Room 4",
"link": "https://meet.example.com/standup",
"all_day": false,
"start": "2026-10-16T11:00",
"end": "2026-10-16T11:15",
"duration": 15,
"timezone": "America/New_York",
"color": null,
"free": false,
"reminders": [
10
],
"guests": [
{
"id": "b8bc98d760d80b652c1b714e88c31882",
"response": "yes"
}
],
"created_by": "9735814189d64dd5dc193fe843b45992",
"starts_at": "2026-10-16T15:00:00.000Z",
"ends_at": "2026-10-16T15:15:00.000Z"
}
],
"more": false
}Tools · Calendars
Returns an event with its guests and occurrence changes. For a repeating event, also returns the occurrence on day, or the next occurrence if day is omitted.
project_id string Requiredspace_id string Requiredlist_spaces.event_id string Requiredday string YYYY-MM-DD.The event, as returned by calendar_get, with exceptions and, for repeating events, an occurrence as returned by calendar_list_events.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calendar_get_event",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "c4a1f0e2b7d94e6a8f3b2c1d0e9f8a7b",
"event_id": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"day": "2026-10-14"
}
}
}'{
"title": "Standup",
"location": "Room 4",
"link": "https://meet.example.com/standup",
"all_day": false,
"start": "2026-10-05T09:30",
"duration": 15,
"timezone": "America/New_York",
"color": null,
"recurrence": "FREQ=WEEKLY;BYDAY=MO,WE,FR",
"free": false,
"reminders": "10",
"description": "",
"id": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"created_by": "9735814189d64dd5dc193fe843b45992",
"created_at": "2026-09-30T23:46:04.480Z",
"updated_at": "2026-09-30T23:46:04.480Z",
"guests": [
{
"id": "b8bc98d760d80b652c1b714e88c31882",
"response": "yes"
}
],
"exceptions": [
{
"id": "0d9c8b7a6f5e44d3c2b1a09f8e7d6c5b",
"event_id": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"day": "2026-10-16",
"cancelled": false,
"changes": {
"start": "2026-10-16T11:00"
},
"created_at": "2026-09-30T23:46:04.495Z",
"updated_at": "2026-09-30T23:46:04.495Z"
}
],
"occurrence": {
"id": "5e2d8c7b1a094f3e86d7c5b4a3928170:2026-10-14",
"event_id": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"day": "2026-10-14",
"exception_id": null,
"recurring": true,
"recurrence": "FREQ=WEEKLY;BYDAY=MO,WE,FR",
"title": "Standup",
"description": "",
"location": "Room 4",
"link": "https://meet.example.com/standup",
"all_day": false,
"start": "2026-10-14T09:30",
"end": "2026-10-14T09:45",
"duration": 15,
"timezone": "America/New_York",
"color": null,
"free": false,
"reminders": [
10
],
"guests": [
{
"id": "b8bc98d760d80b652c1b714e88c31882",
"response": "yes"
}
],
"created_by": "9735814189d64dd5dc193fe843b45992",
"starts_at": "2026-10-14T13:30:00.000Z",
"ends_at": "2026-10-14T13:45:00.000Z"
}
}Tools · Calendars
Creates an event, or updates the event with the given event_id. Omitted fields are unchanged. A new start without an end keeps the event’s duration. For repeating events, day selects the occurrence and apply_to sets the scope of the change. Invited guests are notified as if mentioned.
project_id string Requiredspace_id string Requiredlist_spaces.event_id string day string YYYY-MM-DD.apply_to enum day. this changes only that occurrence. following ends the series the day before and continues it as a new event, whose id is returned. all (the default) changes the whole series, and a new time shifts every occurrence by the same amount.title string description string location string link string https:// is added if missing. Empty for none.all_day boolean start and end are given.start string YYYY-MM-DD) for all-day events, otherwise a wall time (YYYY-MM-DDTHH:MM) in the event’s time zone.end string timezone string | null color enum | null tomato, flamingo, tangerine, banana, sage, basil, peacock, blueberry, lavender, grape or graphite, or null for the calendar’s color.recurrence string | null FREQ (DAILY, WEEKLY, MONTHLY or YEARLY), INTERVAL, BYMONTHDAY, BYMONTH, and COUNT or UNTIL=YYYYMMDD. It can also use BYDAY, with weekdays (MO,WE) or positions (2TU for the month’s second Tuesday, -1FR for its last Friday), and BYSETPOS, which selects among each period’s matches. For example, BYDAY=MO,TU,WE,TH,FR;BYSETPOS=-1 selects the month’s last weekday. Add RDATE=YYYYMMDD,… for up to 150 extra dates at the same time. These dates are bounded by UNTIL but not counted by COUNT. FREQ=DAILY;COUNT=1;RDATE=… gives only those dates. Pass null to stop repeating. An event occurs at most once per day.free boolean reminders integer[] guests string[] list_people. Applies to every occurrence of a repeating event. Omit to leave the guest list unchanged.The event, as returned by calendar_get_event. With day, the result includes that occurrence.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calendar_save_event",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "c4a1f0e2b7d94e6a8f3b2c1d0e9f8a7b",
"title": "Standup",
"location": "Room 4",
"start": "2026-10-05T09:30",
"end": "2026-10-05T09:45",
"recurrence": "FREQ=WEEKLY;BYDAY=MO,WE,FR",
"reminders": [
10
],
"guests": [
"b8bc98d760d80b652c1b714e88c31882"
]
}
}
}'{
"title": "Standup",
"location": "Room 4",
"link": "https://meet.example.com/standup",
"all_day": false,
"start": "2026-10-05T09:30",
"duration": 15,
"timezone": "America/New_York",
"color": null,
"recurrence": "FREQ=WEEKLY;BYDAY=MO,WE,FR",
"free": false,
"reminders": "10",
"description": "",
"id": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"created_by": "9735814189d64dd5dc193fe843b45992",
"created_at": "2026-09-30T23:46:04.480Z",
"updated_at": "2026-09-30T23:46:04.480Z",
"guests": [
{
"id": "b8bc98d760d80b652c1b714e88c31882",
"response": null
}
],
"exceptions": [],
"occurrence": {
"id": "5e2d8c7b1a094f3e86d7c5b4a3928170:2026-10-16",
"event_id": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"day": "2026-10-16",
"exception_id": null,
"recurring": true,
"recurrence": "FREQ=WEEKLY;BYDAY=MO,WE,FR",
"title": "Standup",
"description": "",
"location": "Room 4",
"link": "https://meet.example.com/standup",
"all_day": false,
"start": "2026-10-16T09:30",
"end": "2026-10-16T09:45",
"duration": 15,
"timezone": "America/New_York",
"color": null,
"free": false,
"reminders": [
10
],
"guests": [
{
"id": "b8bc98d760d80b652c1b714e88c31882",
"response": "yes"
}
],
"created_by": "9735814189d64dd5dc193fe843b45992",
"starts_at": "2026-10-16T13:30:00.000Z",
"ends_at": "2026-10-16T13:45:00.000Z"
}
}Tools · Calendars
Deletes an event. For a repeating event with day, deletes that occurrence, that occurrence and all later ones, or the whole series, depending on apply_to.
project_id string Requiredspace_id string Requiredlist_spaces.event_id string Requiredday string YYYY-MM-DD.apply_to enum this (the default with day), following or all (the default without day).The event’s id, and day if given.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calendar_delete_event",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "c4a1f0e2b7d94e6a8f3b2c1d0e9f8a7b",
"event_id": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"day": "2026-10-19"
}
}
}'{
"deleted": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"day": "2026-10-19"
}Tools · Calendars
Responds to an event invitation on behalf of the person who connected the agent. The person must be a guest. Applies to every occurrence of a repeating event. Fails for agent links, which act as the organization rather than a person.
project_id string Requiredspace_id string Requiredlist_spaces.event_id string Requiredresponse enum | null Requiredyes, no or maybe, or null to withdraw the response.The event’s id and response.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calendar_respond_to_event",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "c4a1f0e2b7d94e6a8f3b2c1d0e9f8a7b",
"event_id": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"response": "yes"
}
}
}'{
"event_id": "5e2d8c7b1a094f3e86d7c5b4a3928170",
"response": "yes"
}Tools · Calendars
Sets a calendar’s default event color, default time zone and week start day. Omitted fields are unchanged.
project_id string Requiredspace_id string Requiredlist_spaces.color enum calendar_save_event.timezone string | null week_start integer The calendar’s settings.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calendar_update_settings",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "c4a1f0e2b7d94e6a8f3b2c1d0e9f8a7b",
"timezone": "America/New_York",
"week_start": 1
}
}
}'{
"color": "peacock",
"timezone": "America/New_York",
"week_start": 1
}Tools · Calendars
Imports events from an iCalendar (.ics) file, including times and time zones, recurrence rules and RDATEs, changed and cancelled occurrences, titles, locations, links (the video call link, or else the URL), descriptions, colors (mapped to the nearest calendar color) and reminders. Attendees are ignored. Events are matched by UID, so importing a file again updates them.
project_id string Requiredspace_id string Requiredlist_spaces.ics string Requiredtimezone string imported, the number of events imported, and once, the number of repeating events imported as single events because their recurrence rule is unsupported.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calendar_import_events",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "c4a1f0e2b7d94e6a8f3b2c1d0e9f8a7b",
"ics": "BEGIN:VCALENDAR\r\nBEGIN:VEVENT\r\nUID:retro@example.com\r\nDTSTART;TZID=America/New_York:20261023T160000\r\nDTEND;TZID=America/New_York:20261023T170000\r\nSUMMARY:Retro\r\nEND:VEVENT\r\nEND:VCALENDAR"
}
}
}'{
"imported": 1,
"once": 0
}Tools · Calendars
Exports a calendar as an iCalendar (.ics) file. Guests become attendees with their responses, and each event’s creator becomes its organizer, identified by email address.
project_id string Requiredspace_id string Requiredlist_spaces.The file contents as ics.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calendar_export",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "c4a1f0e2b7d94e6a8f3b2c1d0e9f8a7b"
}
}
}'{
"ics": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//Tensorworks//Calendar//EN\r\nCALSCALE:GREGORIAN\r\nX-WR-CALNAME:Team calendar\r\n…\r\nEND:VCALENDAR\r\n"
}Questions or something missing? Contact us.