Plugin access to your calendars
A plugin you approve can read the events on the Google and Outlook calendars you pick, and add, edit and delete events on the ones you can change, never more than you could do yourself. Inviting or removing guests and deleting an event always ask you first. It is off until you turn on Plugin access to your calendars in Settings, Labs, and it only works while a calendar is connected.
What it is
A plugin can ask for two permissions, shown on its install card:
| Permission | What it lets the plugin do |
|---|---|
Calendars (calendar.read) |
Read events, guests and meeting links on the calendars you choose, and when you are free or busy. |
Change calendar events (calendar.write) |
Add, edit and delete events on the calendars you choose. Inviting people or deleting asks you first. |
A plugin that asks to change events must also ask to read them, so the card always shows everything it holds. Both permissions are marked as elevated.
Where to find it
- The switch: Settings, Labs, Plugin access to your calendars. It starts off and hidden. It also needs a calendar connected: Google Calendar, or Outlook through Microsoft Teams. With neither, every calendar ability from a plugin is refused.
- Sharing: when a plugin needs your calendars, a picker lists the calendars you can read from each connected account. Tick single calendars, or All your calendars, which covers every calendar you have now or add later. Calendars you can only change in your own calendar app are marked view only.
- Outlook changes: a plugin can change Outlook calendars only after you turn on Let plugins change Outlook calendars under Microsoft Teams, which signs you in to Microsoft again for that one extra permission. Until then Outlook calendars are view only for plugins.
- Review and revoke: Settings, Plugins, the plugin's card lists every calendar it can use (or "All your calendars") with a Revoke button, and every event it added, edited or deleted.
What a plugin can and cannot do
- Can: list the calendars you shared, read their events (title, time, place, description, organizer, guests and their answers, the meeting link), ask when you are free or busy, add an event, edit an event, and delete an event after you say yes.
- Cannot: see a calendar you did not pick, see the events of a calendar you can only see as free or busy, change a calendar you can only view, reach the calendar AI chat or the paid quick-add parser, or see your Google or Microsoft sign-in.
How it behaves
- Nothing is shared until you pick it. A plugin asking about a calendar you did not share gets the same "not found" answer as for one that does not exist.
- Adding or editing your own event runs without asking. Adding an event with guests, changing who is invited, and deleting any event show a question written by Omniscio from its own records: which plugin, which event and when, which calendar, and which guests are added or removed. For one occurrence of a repeating event, the question names its date, and a delete says whether it removes only that occurrence or the whole series. Saying no, closing the dialog, or not answering means nothing changes.
- Google guests are emailed only when the plugin asks for it and you say yes; otherwise no one is emailed. A Google delete never emails guests. Outlook always emails guests, and sends them a cancellation when an event is deleted; the question says so.
- A plugin can retry adding an event without booking it twice, as long as it sends the same request id.
- A plugin never spends Omniscio's money or sees passwords, keys or tokens. Its panel cannot read your events; only its background program can, through Omniscio.
- A plugin can make at most 60 reads and 10 changes a minute, shared with its other work data.
- Revoking, turning the plugin off or uninstalling it stops its very next call, with no restart.
Limits
- A read covers at most 90 days and returns at most 250 events.
- Free or busy time covers at most 20 calendars per question.
- An event can invite at most 50 guests.
- The picker offers at most 100 calendars.
Speed cost
Not measured yet. The feature adds no background work of its own (no timer, poller or watcher); it only does work when a plugin calls it, and each call is capped at 60 reads and 10 changes a minute. Each call asks the calendar account for its list of calendars once. The off-and-on measurement in the shared Speed Cost Format needs a plugin that actually uses these permissions, and is owed before the feature goes to dogfood.
Related
Plugin access to boards and tasks, Plugin control of your sessions and Plugin access to your Vault explain the sibling permissions, the Plugin Marketplace page covers installing plugins and the consent card, and Plugin Developer Mode explains how a self-built plugin can use these permissions before the marketplace lists them.
Last verified 2026-11-12