# Toolcape + Gmail

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
Gmail: Google’s email service. It contains messages, threads, drafts and labels.
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: Find and read relevant email threads
- Create: Create a draft or send an email
- Change: Organize messages with labels
Reading, drafting and sending are different actions. Allow sending only when it is needed.

## 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.
- gmailUsersGetProfile — Get Users Profile
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/profile
  https://developers.google.com/workspace/gmail/api/
- gmailUsersWatch — Users Watch
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/watch
  https://developers.google.com/workspace/gmail/api/
- gmailUsersStop — Users Stop
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/stop
  https://developers.google.com/workspace/gmail/api/
- gmailUsersThreadsGet — Get Users Threads
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersThreadsDelete — Delete Users Threads
  DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersThreadsTrash — Users Threads Trash
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}/trash
  https://developers.google.com/workspace/gmail/api/
- gmailUsersThreadsList — List Users Threads
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/threads
  https://developers.google.com/workspace/gmail/api/
- gmailUsersThreadsModify — Users Threads Modify
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}/modify
  https://developers.google.com/workspace/gmail/api/
- gmailUsersThreadsUntrash — Users Threads Untrash
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}/untrash
  https://developers.google.com/workspace/gmail/api/
- gmailUsersHistoryList — List Users History
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/history
  https://developers.google.com/workspace/gmail/api/
- gmailUsersLabelsList — List Users Labels
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/labels
  https://developers.google.com/workspace/gmail/api/
- gmailUsersLabelsCreate — Create Users Labels
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/labels
  https://developers.google.com/workspace/gmail/api/
- gmailUsersLabelsGet — Get Users Labels
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/labels/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersLabelsUpdate — Update Users Labels
  PUT https://gmail.googleapis.com/gmail/v1/users/{userId}/labels/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersLabelsDelete — Delete Users Labels
  DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/labels/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersLabelsPatch — Patch Users Labels
  PATCH https://gmail.googleapis.com/gmail/v1/users/{userId}/labels/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersDraftsList — List Users Drafts
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts
  https://developers.google.com/workspace/gmail/api/
- gmailUsersDraftsCreate — Create Users Drafts
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts
  https://developers.google.com/workspace/gmail/api/
- gmailUsersDraftsGet — Get Users Drafts
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersDraftsUpdate — Update Users Drafts
  PUT https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersDraftsDelete — Delete Users Drafts
  DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersDraftsSend — Send Users Drafts
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts/send
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsGetPop — Get Users Settings Pop
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/pop
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsUpdatePop — Update Users Settings Pop
  PUT https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/pop
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsGetVacation — Get Users Settings Vacation
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/vacation
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsUpdateVacation — Update Users Settings Vacation
  PUT https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/vacation
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsGetAutoForwarding — Get Users Settings Auto Forwarding
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/autoForwarding
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsUpdateAutoForwarding — Update Users Settings Auto Forwarding
  PUT https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/autoForwarding
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsGetLanguage — Get Users Settings Language
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/language
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsUpdateLanguage — Update Users Settings Language
  PUT https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/language
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsGetImap — Get Users Settings Imap
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/imap
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsUpdateImap — Update Users Settings Imap
  PUT https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/imap
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsCseIdentitiesList — List Users Settings Cse Identities
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsCseIdentitiesCreate — Create Users Settings Cse Identities
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsCseIdentitiesGet — Get Users Settings Cse Identities
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsCseIdentitiesDelete — Delete Users Settings Cse Identities
  DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsCseIdentitiesPatch — Patch Users Settings Cse Identities
  PATCH https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities/{emailAddress}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsCseKeypairsDisable — Users Settings Cse Keypairs Disable
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:disable
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsCseKeypairsEnable — Users Settings Cse Keypairs Enable
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:enable
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsCseKeypairsList — List Users Settings Cse Keypairs
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsCseKeypairsCreate — Create Users Settings Cse Keypairs
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsCseKeypairsObliterate — Users Settings Cse Keypairs Obliterate
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsCseKeypairsGet — Get Users Settings Cse Keypairs
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsSendAsGet — Send Users Settings As Get
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsSendAsUpdate — Send Users Settings As Update
  PUT https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsSendAsDelete — Send Users Settings As Delete
  DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsSendAsPatch — Send Users Settings As Patch
  PATCH https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsSendAsList — Send Users Settings As List
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsSendAsCreate — Send Users Settings As Create
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsSendAsVerify — Send Users Settings As Verify
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsSendAsSmimeInfoSetDefault — Send Users Settings As Smime Info Set Default
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsSendAsSmimeInfoGet — Send Users Settings As Smime Info Get
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsSendAsSmimeInfoDelete — Send Users Settings As Smime Info Delete
  DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsSendAsSmimeInfoList — Send Users Settings As Smime Info List
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsSendAsSmimeInfoInsert — Send Users Settings As Smime Info Insert
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsDelegatesList — List Users Settings Delegates
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsDelegatesCreate — Create Users Settings Delegates
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsDelegatesGet — Get Users Settings Delegates
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsDelegatesDelete — Delete Users Settings Delegates
  DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsFiltersGet — Get Users Settings Filters
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/filters/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsFiltersDelete — Delete Users Settings Filters
  DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/filters/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsFiltersList — List Users Settings Filters
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/filters
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsFiltersCreate — Create Users Settings Filters
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/filters
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsForwardingAddressesList — List Users Settings Forwarding Addresses
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/forwardingAddresses
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsForwardingAddressesCreate — Create Users Settings Forwarding Addresses
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/forwardingAddresses
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsForwardingAddressesGet — Get Users Settings Forwarding Addresses
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersSettingsForwardingAddressesDelete — Delete Users Settings Forwarding Addresses
  DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersMessagesBatchModify — Batch Users Messages Modify
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchModify
  https://developers.google.com/workspace/gmail/api/
- gmailUsersMessagesBatchDelete — Batch Users Messages Delete
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchDelete
  https://developers.google.com/workspace/gmail/api/
- gmailUsersMessagesList — List Users Messages
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/messages
  https://developers.google.com/workspace/gmail/api/
- gmailUsersMessagesInsert — Insert Users Messages
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages
  https://developers.google.com/workspace/gmail/api/
- gmailUsersMessagesModify — Users Messages Modify
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}/modify
  https://developers.google.com/workspace/gmail/api/
- gmailUsersMessagesTrash — Users Messages Trash
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}/trash
  https://developers.google.com/workspace/gmail/api/
- gmailUsersMessagesUntrash — Users Messages Untrash
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}/untrash
  https://developers.google.com/workspace/gmail/api/
- gmailUsersMessagesGet — Get Users Messages
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersMessagesDelete — Delete Users Messages
  DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}
  https://developers.google.com/workspace/gmail/api/
- gmailUsersMessagesImport — Users Messages Import
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import
  https://developers.google.com/workspace/gmail/api/
- gmailUsersMessagesSend — Send Users Messages
  POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/send
  https://developers.google.com/workspace/gmail/api/
- gmailUsersMessagesAttachmentsGet — Get Users Messages Attachments
  GET https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{messageId}/attachments/{id}
  https://developers.google.com/workspace/gmail/api/

## A useful first question
Find the email where Anne confirmed the meeting time.

## 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.