PlugsightDocs

What your AI can do with calendars

Every calendar action Plugsight gives your AI (events, free time, booking, moving and cancelling), the rules for changes and the messages you may see.

When an MCP server includes a calendar connection (Outlook Calendar, iCloud Calendar or Google Calendar), your AI gets the actions below. Events are read live from your calendar when your AI asks, and Plugsight doesn't store them.

You don't need to name the actions: ask in plain words. The names are shown so you can recognise them in your AI app and on Activity.

Reading

List calendars (calendar_list_calendars)

The calendars this connection can see, with each one's time zone, whether it's your main (primary) calendar, and whether events can be added to it.

  • "Which calendars do you see in my Outlook?"

List events (calendar_list_events)

Events between two dates or times, across all your calendars or one, optionally matching text in the title, description, location or guests. Repeating events are listed occurrence by occurrence. Up to 500 events at a time.

  • "What's on my calendar this week?"
  • "When did I last meet Priya, and what was it about?"
  • "How many hours of meetings did I have last month?"

Find free time (calendar_find_free_time)

Your busy times across all your calendars between two dates or times, and the free gaps of at least a given length (5 minutes to 24 hours; 30 minutes unless you say otherwise).

  • "Find three 45-minute slots next week when I'm free in the afternoon."
  • "When am I free on Thursday?"

Changing (Outlook and iCloud calendars)

These actions appear only when at least one calendar connection in the MCP server is allowed to book. Google Calendar can't be booked yet: see Google Calendar.

Before any change, your AI shows you the calendar, title, date, start and end time with time zone, location and every guest, and waits for your clear yes. It never books, moves or cancels on its own initiative.

Book an event (calendar_create_event)

Creates an event on your main calendar (or one you name), optionally with a description, location and guests to invite. All-day events are supported. Guests get an email invitation unless you say not to (Outlook always sends invitations: see below).

Change an event (calendar_update_event)

Moves an event, or changes its title, description or location, or adds guests. Only what you ask for changes. To move an event, your AI gives both a new start and a new end.

  • "Move Friday's team review to Monday at the same time and let everyone know."

Cancel an event (calendar_cancel_event)

Deletes an event and, unless you say not to, emails guests a cancellation.

  • "Cancel my 4pm on Thursday."

Repeating events

  • Outlook: changing or cancelling affects only the one occurrence.
  • iCloud: changing or cancelling affects the whole series.

What changes need

All of these must be true:

  1. Your plan includes changes (Pro or Agency).
  2. Nothing is paused on Permissions: neither Pause everything nor the Calendar pause.
  3. The MCP server allows changes: Allow changes ticked under Edit configuration.
  4. The connection may book: on Connections, its switch says Can book & change. When off, it says Read-only.
  5. You said yes in the chat to the exact details.

There's no daily limit for calendar changes. Every change is listed on Activity.

Hide a calendar from your AI

On Connections, click Show calendars under the calendar connection, then switch off any calendar you want hidden. Your AI never reads, searches or books hidden calendars, even if asked for one by name.

Several calendar connections

When an MCP server has more than one calendar connection, your AI needs to know which to use: name it, for example "on my iCloud calendar". Each connection's id is shown by "List my Plugsight accounts".

Messages your AI may show

Calendar changes are paused (Permissions page).

What it means: the Calendar type is paused.

How to fix it: on Permissions, click Resume next to Calendar.

All write actions are paused for this account (Permissions page).

What it means: Pause everything is on.

How to fix it: on Permissions, click Resume all.

The "…" MCP is read-only. Allow changes on the MCP server first (MCP servers page).

What it means: the MCP server your AI app uses has Allow changes unticked.

How to fix it: on MCP servers, open that server, click Edit configuration and tick Allow changes.

Changes are off for "…". Allow them under Connections first.

What it means: the calendar connection's switch says Read-only.

How to fix it: on Connections, click the switch so it says Can book & change.

Sending email and changing helpdesk tickets are on the Pro plan. Upgrade under Billing to turn write access on.

What it means: your plan is Free, which doesn't include changes of any kind, calendar booking included.

How to fix it: upgrade under Billing.

You can only view "…", not change it. Pick another calendar.

What it means: you can see that calendar but not edit it, for example one shared with you read-only.

How to fix it: ask your AI to use one of your own calendars. "List my calendars" shows which ones can have events added.

Unknown or hidden calendar. Call calendar_list_calendars.

What it means: the calendar doesn't exist, or you've hidden it from your AI.

How to fix it: show the calendar again on Connections (Show calendars), or ask your AI to use another one.

What it means: your AI tried to add a Google Meet link to an Outlook or iCloud event.

How to fix it: ask for the video link to go in the description.

This MCP has 2 calendar connections; pass account (one of: …).

What it means: your AI didn't say which calendar connection to use.

How to fix it: name the calendar connection in your request.