PlugsightDocs

Calendar tools

Every calendar tool in the developer API, with arguments and examples: list events, find free time, book and change events.

Needs: Google, Outlook or iCloud Calendar. 6 tools.

These tools appear in GET /v1/tools only when the API key's MCP server includes a connection of this kind. Call each one with POST /v1/tools/\<name>, sending its arguments as a JSON object. See Calling tools for the request and response format.

Tool What it does Kind
calendar_list_calendars List calendars Read
calendar_list_events List calendar events Read
calendar_find_free_time Find free time Read
calendar_create_event Book a calendar event Change
calendar_update_event Change a calendar event Change
calendar_cancel_event Cancel a calendar event Change

Change tools in this group: calendar_create_event, calendar_update_event, calendar_cancel_event. Check each tool's notes below for what it needs before it runs.

The example requests fill in only the required arguments, with placeholder values.

calendar_list_calendars

List calendars · Read

Calendars this connection can read (Google or iCloud), with their ids, time zones and whether events can be added.

Argument Type Required What it is
account string No Connection id from list_accounts (optional when there's only one of this type)

Example request:

curl -X POST https://app.plugsight.app/v1/tools/calendar_list_calendars \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

calendar_list_events

List calendar events · Read

Events between two times, across all visible calendars or one, optionally matching text. Times are ISO 8601 (e.g. "2026-11-20T09:00:00+04:00") or dates (YYYY-MM-DD). Recurring events are expanded.

Argument Type Required What it is
from string Yes Start: ISO date-time or YYYY-MM-DD
to string Yes End: ISO date-time or YYYY-MM-DD (inclusive for dates)
query string No Text to match in title, description, location or attendees
calendar_id string No One calendar id from calendar_list_calendars; default all visible
limit integer No Most results to return. Default 100.
account string No Connection id from list_accounts (optional when there's only one of this type)

Example request:

curl -X POST https://app.plugsight.app/v1/tools/calendar_list_events \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from": "2026-11-01", "to": "2026-11-15"}'

calendar_find_free_time

Find free time · Read

Busy times across visible calendars between two times, and free gaps of at least min_minutes. Use it to suggest meeting slots.

Argument Type Required What it is
from string Yes Start: ISO date-time or YYYY-MM-DD
to string Yes End: ISO date-time or YYYY-MM-DD
min_minutes integer No Shortest free slot to return, in minutes. Default 30.
account string No Connection id from list_accounts (optional when there's only one of this type)

Example request:

curl -X POST https://app.plugsight.app/v1/tools/calendar_find_free_time \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from": "2026-11-01", "to": "2026-11-15"}'

calendar_create_event

Book a calendar event · Change

Creates an event, optionally inviting guests (and, on Google calendars, adding a Google Meet link). Check calendar_find_free_time first. Times are ISO 8601 with offset (e.g. "2026-11-20T15:00:00+04:00"), or YYYY-MM-DD for all-day events (end is the day after).

This tool makes a change, so the request must include "confirm": true, and changes must be allowed. See Making changes.

Argument Type Required What it is
title string Yes Event title
start string Yes ISO date-time with offset, or YYYY-MM-DD for all day
end string Yes ISO date-time with offset, or YYYY-MM-DD (exclusive) for all day
time_zone string No IANA zone, e.g. "Europe/London"; default the calendar's
description string No Description
location string No Location
guests array of string No Email addresses to invite
google_meet boolean No Add a Google Meet video link (Google calendars only) Default false.
notify_guests boolean No Email the guests (invitations, updates or cancellation) Default true.
calendar_id string No Default: the primary calendar
account string No Connection id from list_accounts (optional when there's only one of this type)
confirm boolean Yes Must be true: the user approved these exact details

Example request:

curl -X POST https://app.plugsight.app/v1/tools/calendar_create_event \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "…", "start": "2026-11-20T15:00:00+00:00", "end": "2026-11-20T15:30:00+00:00", "confirm": true}'

calendar_update_event

Change a calendar event · Change

Moves or edits an event: new time, title, description, location, or more guests. Only the fields given change. Use the event id from calendar_list_events.

This tool makes a change, so the request must include "confirm": true, and changes must be allowed. See Making changes.

Argument Type Required What it is
event_id string Yes Event id from calendar_list_events
calendar_id string No The event's calendar; default the primary calendar
title string No New title
start string No New start, ISO 8601 date-time
end string No New end, ISO 8601 date-time
time_zone string No IANA time zone, e.g. Europe/London
description string No Description
location string No Location
add_guests array of string No Guest email addresses to invite
notify_guests boolean No Email the guests (invitations, updates or cancellation) Default true.
account string No Connection id from list_accounts (optional when there's only one of this type)
confirm boolean Yes Must be true: the user approved these exact details

Example request:

curl -X POST https://app.plugsight.app/v1/tools/calendar_update_event \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id": "…", "confirm": true}'

calendar_cancel_event

Cancel a calendar event · Change

Deletes an event and, by default, emails guests a cancellation. For a repeating event, Google cancels only the given occurrence; iCloud cancels the whole series.

This tool makes a change, so the request must include "confirm": true, and changes must be allowed. See Making changes.

Argument Type Required What it is
event_id string Yes Event id from calendar_list_events
calendar_id string No Calendar id from calendar_list_calendars (default: the main calendar)
notify_guests boolean No Email the guests (invitations, updates or cancellation) Default true.
account string No Connection id from list_accounts (optional when there's only one of this type)
confirm boolean Yes Must be true: the user approved these exact details

Example request:

curl -X POST https://app.plugsight.app/v1/tools/calendar_cancel_event \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id": "…", "confirm": true}'