# Toolcape + Google Calendar

Toolcape connects a company’s existing AI to its systems through one MCP entry point, with account connections, group and individual permissions, and audit logs. This documentation describes a product prototype; it is not evidence that a live server or account is connected.

## The connection
Google Calendar: Google’s calendar for meetings, participants and availability.
API connection · AI uses Toolcape through MCP
Provider sign-in (OAuth). Confirm whether the configured connection acts as the user or uses application permissions.

## Typical actions
- Read: Read meetings and availability
- Create: Create a meeting invitation
- Change: Change a meeting time or participants
Changing a meeting can affect other people and send notifications. Reading the calendar is a useful first step.

## Setup
1. IT configures the provider app, API and requested scopes.
2. Provider sign-in (OAuth). Confirm whether the configured connection acts as the user or uses application permissions.
3. Make the service available in Toolcape. Set Everyone, group and individual rules for the actions actually needed. Adding a service does not grant access.
4. Connect the approved AI client to the actual Toolcape MCP address and sign in. Start with a harmless read-only task and check the audit log.

## Permissions
For personal delegated access, the provider account, approved app scopes and Toolcape rules must all permit the action. Shared accounts and application permissions may have other limits. Toolcape combines Everyone and group grants; a personal exception replaces inherited access for that service. Reading can disclose confidential information. Sharing, sending and deletion need separate consideration.

## Calling an operation
First discover which tools the connected Toolcape server actually exposes. If it offers search → describe → execute, find the relevant operation, inspect its input schema and permissions, then call it with validated inputs. Tool names vary by server; do not invent names, arguments, URLs or successful outcomes. Without connected tools, give setup guidance instead of claiming to perform actions.

## Operation reference
Catalog snapshot: 16 September 2026. Verify the current schema before calling.
- calendarAclGet — Get Acl
  GET https://www.googleapis.com/calendar/v3/calendars/{calendarId}/acl/{ruleId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarAclUpdate — Update Acl
  PUT https://www.googleapis.com/calendar/v3/calendars/{calendarId}/acl/{ruleId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarAclDelete — Delete Acl
  DELETE https://www.googleapis.com/calendar/v3/calendars/{calendarId}/acl/{ruleId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarAclPatch — Patch Acl
  PATCH https://www.googleapis.com/calendar/v3/calendars/{calendarId}/acl/{ruleId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarAclList — List Acl
  GET https://www.googleapis.com/calendar/v3/calendars/{calendarId}/acl
  https://developers.google.com/workspace/calendar/firstapp
- calendarAclInsert — Insert Acl
  POST https://www.googleapis.com/calendar/v3/calendars/{calendarId}/acl
  https://developers.google.com/workspace/calendar/firstapp
- calendarAclWatch — Acl Watch
  POST https://www.googleapis.com/calendar/v3/calendars/{calendarId}/acl/watch
  https://developers.google.com/workspace/calendar/firstapp
- calendarColorsGet — Get Colors
  GET https://www.googleapis.com/calendar/v3/colors
  https://developers.google.com/workspace/calendar/firstapp
- calendarSettingsList — List Settings
  GET https://www.googleapis.com/calendar/v3/users/me/settings
  https://developers.google.com/workspace/calendar/firstapp
- calendarSettingsWatch — Settings Watch
  POST https://www.googleapis.com/calendar/v3/users/me/settings/watch
  https://developers.google.com/workspace/calendar/firstapp
- calendarSettingsGet — Get Settings
  GET https://www.googleapis.com/calendar/v3/users/me/settings/{setting}
  https://developers.google.com/workspace/calendar/firstapp
- calendarCalendarListList — List Calendar List
  GET https://www.googleapis.com/calendar/v3/users/me/calendarList
  https://developers.google.com/workspace/calendar/firstapp
- calendarCalendarListInsert — List Calendar Insert
  POST https://www.googleapis.com/calendar/v3/users/me/calendarList
  https://developers.google.com/workspace/calendar/firstapp
- calendarCalendarListGet — List Calendar Get
  GET https://www.googleapis.com/calendar/v3/users/me/calendarList/{calendarId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarCalendarListUpdate — List Calendar Update
  PUT https://www.googleapis.com/calendar/v3/users/me/calendarList/{calendarId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarCalendarListDelete — List Calendar Delete
  DELETE https://www.googleapis.com/calendar/v3/users/me/calendarList/{calendarId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarCalendarListPatch — List Calendar Patch
  PATCH https://www.googleapis.com/calendar/v3/users/me/calendarList/{calendarId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarCalendarListWatch — List Calendar Watch
  POST https://www.googleapis.com/calendar/v3/users/me/calendarList/watch
  https://developers.google.com/workspace/calendar/firstapp
- calendarChannelsStop — Channels Stop
  POST https://www.googleapis.com/calendar/v3/channels/stop
  https://developers.google.com/workspace/calendar/firstapp
- calendarCalendarsGet — Get Calendars
  GET https://www.googleapis.com/calendar/v3/calendars/{calendarId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarCalendarsUpdate — Update Calendars
  PUT https://www.googleapis.com/calendar/v3/calendars/{calendarId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarCalendarsDelete — Delete Calendars
  DELETE https://www.googleapis.com/calendar/v3/calendars/{calendarId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarCalendarsPatch — Patch Calendars
  PATCH https://www.googleapis.com/calendar/v3/calendars/{calendarId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarCalendarsTransferOwnership — Calendars Transfer Ownership
  POST https://www.googleapis.com/calendar/v3/calendars/{calendarId}/transferOwnership
  https://developers.google.com/workspace/calendar/firstapp
- calendarCalendarsClear — Calendars Clear
  POST https://www.googleapis.com/calendar/v3/calendars/{calendarId}/clear
  https://developers.google.com/workspace/calendar/firstapp
- calendarCalendarsInsert — Insert Calendars
  POST https://www.googleapis.com/calendar/v3/calendars
  https://developers.google.com/workspace/calendar/firstapp
- calendarEventsGet — Get Events
  GET https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events/{eventId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarEventsUpdate — Update Events
  PUT https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events/{eventId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarEventsDelete — Delete Events
  DELETE https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events/{eventId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarEventsPatch — Patch Events
  PATCH https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events/{eventId}
  https://developers.google.com/workspace/calendar/firstapp
- calendarEventsList — List Events
  GET https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events
  https://developers.google.com/workspace/calendar/firstapp
- calendarEventsInsert — Insert Events
  POST https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events
  https://developers.google.com/workspace/calendar/firstapp
- calendarEventsMove — Move Events
  POST https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events/{eventId}/move
  https://developers.google.com/workspace/calendar/firstapp
- calendarEventsQuickAdd — Add Events Quick
  POST https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events/quickAdd
  https://developers.google.com/workspace/calendar/firstapp
- calendarEventsImport — Events Import
  POST https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events/import
  https://developers.google.com/workspace/calendar/firstapp
- calendarEventsWatch — Events Watch
  POST https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events/watch
  https://developers.google.com/workspace/calendar/firstapp
- calendarEventsInstances — Events Instances
  GET https://www.googleapis.com/calendar/v3/calendars/{calendarId}/events/{eventId}/instances
  https://developers.google.com/workspace/calendar/firstapp
- calendarFreebusyQuery — Freebusy Query
  POST https://www.googleapis.com/calendar/v3/freeBusy
  https://developers.google.com/workspace/calendar/firstapp

## A useful first question
When are we both free for a meeting next week?

## If it fails
Check the account, expired authorization, app approval, provider scopes and Toolcape permissions. Share only redacted errors with support. Never paste passwords, tokens or client secrets into an AI conversation.