Connected accounts
Connect Google, Slack, GitHub and Notion so agents can use Gmail, Drive, Calendar, Sheets, Slack channels, GitHub issues and Notion pages.
Settings → Connections → Connected accounts. Needs oauthConnection.manage (Owner/Admin) to
connect; oauthConnection.read to view.
Connecting
Click Connect next to a provider (which ones appear depends on the deployment: Google, Slack,
GitHub, Notion). You are sent to their consent page, accept the scopes, and come back with
?connected=. On cancel or error the page shows ?error= with a message.
A connection belongs to the workspace: every agent in it with the matching tool uses it, and actions run as the connected account (an email goes out from that Gmail, a Slack message posts as that user). Prefer a service account over a personal one where you can.
Tools it unlocks
| Provider | Tools |
|---|---|
| Search Gmail, Send from Gmail, Search Google Drive, Read Google Calendar, Read a Google Sheet, Append to a Google Sheet | |
| Slack | Post to Slack, Read a Slack channel |
| GitHub | Search GitHub issues, Open a GitHub issue |
| Notion | Search Notion |
In Configure an agent, a tool without its connection shows Needs the X connection.
Status
- connected — ready.
- cannot renew — the token expired and could not be refreshed (usually because access was revoked on the provider's side). Click Connect again.
Disconnect (with confirmation) removes it; agents relying on it will report the tool as unavailable.