> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zerotwo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect an App

> Step-by-step guide to connecting any of ZeroTwo's 45+ OAuth integrations.

Connecting an app to ZeroTwo takes about 30 seconds. Once connected, the app is immediately available in Agent Mode, Tasks, Skills, and via @ mentions in chat.

<Tip>
  Start with your most-used productivity apps — Google Drive, Gmail, Notion, and GitHub — to unlock the most value from Agent Mode and @ mentions right away.
</Tip>

## Connect an integration

<Steps>
  <Step title="Open Settings → Connectors">
    Click the gear icon in the bottom-left sidebar to open Settings, then select the **Connectors** tab. You'll see a grid of all available integrations.
  </Step>

  <Step title="Find the app you want to connect">
    Browse the integration grid by category, or use the search box at the top to find a specific app by name.
  </Step>

  <Step title="Click the app">
    Click the app's tile to open its connector detail panel. You'll see a description of what the connector can do and which permissions it requests.
  </Step>

  <Step title="Click Connect">
    Click the **Connect** button. ZeroTwo will prepare the OAuth authorization request.
  </Step>

  <Step title="Authorize via the app's OAuth page">
    Your browser is redirected to the app's official authorization page (e.g., Google's consent screen, GitHub's OAuth page). Review the requested permissions carefully, then click **Allow** or **Authorize**.
  </Step>

  <Step title="Return to ZeroTwo">
    After authorizing, you're redirected back to ZeroTwo automatically. The connector tile will now show a **Connected** badge.
  </Step>
</Steps>

That's it. The app is now available across ZeroTwo.

## Using a connected app

Once connected, you can invoke any app in several ways:

**@ mentions in chat**

Type `@` in any chat input. A dropdown appears showing your connected apps. Select the app to pull it into your current conversation context.

```
@Google Drive find my Q3 budget spreadsheet
@GitHub list open pull requests in zerotwo/frontend
@Notion summarize the meeting notes from last week
```

**Agent Mode**

In Agent Mode, connected apps are automatically available as tools. The agent will use them as needed to complete your task without requiring explicit @ mentions.

**Tasks**

When creating a scheduled or event-triggered Task, you can reference connected apps in the task instructions. The task will use your authorized connection when it runs.

## Multiple accounts

Some apps support connecting multiple accounts. For example, you might connect both a personal Google account and a work Google account. Each account appears as a separate connector entry in Settings → Connectors. When using @ mentions, you can specify which account to use.

<Info>
  Not all apps support multiple account connections. Apps that do support it will show an "Add another account" option after the first connection is established.
</Info>

## Reconnecting an app

If a connector shows **"Needs reauthorization"** or an error state, the OAuth token has expired or been revoked on the app's side. To fix it:

1. Go to **Settings → Connectors**
2. Click the affected app
3. Click **Reconnect**
4. Complete the OAuth flow again

After reconnecting, any tasks or agents using that connector will resume working normally.

## What happens after connecting

| What changes      | Details                                                  |
| ----------------- | -------------------------------------------------------- |
| **@ mentions**    | The app appears in the mention dropdown in any chat      |
| **Agent Mode**    | The agent can use the app as a tool for tasks you assign |
| **Tasks**         | You can reference the app in task instructions           |
| **Skills**        | Skills scoped to this app become available               |
| **Custom Agents** | You can assign this connector to custom agents you build |

## Connector permissions at a glance

When you connect an app, ZeroTwo requests only the OAuth scopes needed for the features it supports. These scopes are displayed on the app's authorization page before you approve. You can review exactly what ZeroTwo can and cannot do with each app.

<Note>
  If you want to change the permissions granted to a connector (e.g., add write access to an app you previously connected read-only), you need to disconnect and reconnect. The new OAuth flow will request the updated scopes.
</Note>