OpenAssistantAPI
→

Connections

Link your calendar, email, and other services so your assistant can act on your behalf.

What connections are

A connection gives your assistant access to an external service under your identity. Without connections, your assistant can have a conversation and create tasks — but it can't read your calendar, send email, or interact with any service on your behalf.

Connections are personal: each user connects their own accounts. They're managed on the Connections page in your settings, which also holds your extra email addresses and phone numbers (verified with a code), plus Defaults — your preferred service for each category and your preferred way for your assistant to contact people (email, iMessage, SMS, or WhatsApp).

Google

Connecting Google gives your assistant access to your Google Workspace services. When you connect, you choose which parts to allow (Calendar is always included):

Google Calendar — your assistant can read your availability, create and update events, and participate in scheduling coordination. This is the most fundamental connection: without it, your assistant can't book anything on your behalf.

Gmail — your assistant can search and read your inbox, and (with read/write permission) send emails, archive messages, add labels, and save drafts. When Gmail is connected, outbound emails from your assistant come from your actual Gmail address rather than your assistant's default address.

Google Contacts — your assistant can see and manage the contacts you're meeting.

Google Drive — your assistant can access and attach files from your Drive. Tasks that involve documents or files can pull from Drive directly. Off by default until you turn it on.

Meeting Notes — import notes and transcripts from your Google Meet meetings. Off by default.

Microsoft

Connecting Microsoft gives your assistant access to your Microsoft 365 services:

Outlook Calendar — same as Google Calendar: availability, event creation, and scheduling.

Outlook Mail — search, read, and send via your Outlook address. With read/write permission, your assistant can also archive, flag, and organize your inbox.

Microsoft Contacts — same as Google Contacts.

OneDrive — file access and attachments from OneDrive.

Meeting Notes — import notes and transcripts from your Teams meetings. Off by default.

Apple and Zoom

Apple connects your iCloud Calendar. Zoom lets your assistant create and manage Zoom meetings and access your Zoom recordings.

Slack and Microsoft Teams

Unlike the connections above, Slack and Teams aren't something you personally connect — your company's workspace is connected once, for everyone, by an org admin or IT. See Slack & Teams for how that works and what it looks like once it's set up. If you try to message your assistant there and nothing happens, your workspace probably just hasn't been connected yet — ask your admin.

Permission levels

Each part of a Google or Microsoft connection (calendar, contacts, inbox, files) has its own level, which you can change any time from that connection's Access section:

LevelWhat your assistant can do
OffNothing — your assistant doesn't use that part
ReadLook things up only — for email, search the inbox, read emails, list threads; no sending or modifying
Read & WriteEverything in read, plus make changes — for email, send, archive, label, draft, move to trash; for calendar, create and update events

Calendar, contacts, and inbox default to Read & Write; files and meeting notes start off. Your team or org admin may lock a level. When one is locked you'll see "Locked by your team admin" or "Locked by your organization" and can't change it.

What happens if a connection breaks

OAuth tokens expire or get revoked when you change your account password, revoke app access in your provider settings, or your token reaches its expiration. When this happens:

  • Your assistant loses access to that service immediately
  • The connection's card on the Connections page shows Expired or Disconnected
  • Tasks that depend on the connection will pause or fail until you reconnect

To reconnect, open Connections and click Reconnect on the affected service. If it's no longer needed, you can remove it instead.

Connections for skills

Some skills require their own connections — for example, a Salesforce skill needs your Salesforce credentials. These are managed separately from your calendar and email connections, and show up as their own cards on the Connections page. Depending on the service you sign in with OAuth or paste an API key. The skill's store page will tell you exactly what it needs before you install. If your admin allows it, Add New Connection lets you add your own MCP or CLI connection by pasting its URL.