Skip to content
Sign inSign up

Google Connections

Connect Horizon to Gmail, Google Calendar, and Google Drive — three separate connections, each authorized on its own.

Horizon connects to Google as three separate connections — Gmail, Google Calendar, and Google Drive. There is no single “Google Workspace” connection, and no place to switch parts of Google on and off within one.

Connect only the ones you need. Each is authorized on its own, appears as its own card in Workspace > Connections, and can be removed without disturbing the others.

Note

Google Meet is reached through the Google Calendar connection rather than one of its own, because a Meet link is a property of a calendar event.

Prerequisites

  • A Google account with access to the mailbox, calendar, or Drive files you want agents to work with.
  • If your organization restricts third-party apps, an administrator may need to permit Horizon first.

Setting Up a Connection

Repeat this for each of the three you want.

  1. Navigate to Workspace > Connections and click Connect Service.
  2. Select Gmail, Google Calendar, or Google Drive from the list.
  3. Click Connect. You will be redirected to Google’s sign-in page.
  4. Choose the Google account to authorize.
  5. Review what Horizon is asking for and approve all of it.
Caution

Google’s consent screen lets you untick individual permissions. If you do, the connection is created but marked unusable, and the fix is to disconnect it and connect again approving everything. The consent screen is the authoritative statement of what each connection asks for.

Agents act as the account that authorized the connection and see exactly what that account can see.

What Agents Can Do

Gmail

  • Search the mailbox for messages.
  • Read a specific message.
  • Compose and send an email.

Google Calendar

  • Search events.
  • Read a specific event.
  • Create an event.
  • Update an existing event.

Google Drive

  • Search Drive for files.
  • Read a specific file.
  • Create a Google Doc, Sheet, or Slides deck.
  • Update an existing Doc, Sheet, or Slides deck.
Note

Search runs per connection. An agent with all three searches Gmail, Calendar, and Drive as three separate operations — there is no single search across all of your Google data.

Troubleshooting

IssueResolution
Connection shows expired or requires_reconnectionClick Disconnect on that connection’s card, then Connect Service and set it up again. There is no re-authorize button.
Connection was made but skills failA permission was probably withheld at the consent screen. Disconnect, reconnect, and approve everything.
An agent can reach Calendar but not DriveThese are separate connections. Check the one that is missing is actually connected.
Agent cannot see a file or messageThe authorizing account cannot see it either. Share it with that account, or authorize an account that has access.

Disconnecting

Click Disconnect on the relevant card in Workspace > Connections and confirm. This removes only that connection — Gmail, Calendar, or Drive — and leaves the other two in place.

This deletes Horizon’s stored tokens. To also withdraw access at Google, visit myaccount.google.com/permissions and remove Horizon.