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

# Integrations

> The apps your playbook uses, and how to connect them

An **integration** is an app your playbook talks to — Gmail to send email, Slack to post a message, Google Sheets to read a row, and so on. Aident keeps the connection to each app so your playbook can act on your behalf.

You'll run into integrations in two places: right inside the **Playbook editor**, and on the **Capabilities** page in the left sidebar.

***

## In the Playbook Editor

On the editor canvas, the **⚙️ Integrations** section shows one pill for every app the playbook uses. The pill's color tells you what to do.

<AccordionGroup>
  <Accordion title="White pill — ready to use">
    Connected and working. The playbook can use the app as-is.
  </Accordion>

  <Accordion title="Orange pill — needs connecting">
    You haven't signed in to this app yet. Click the pill, finish the sign-in, and come back.
  </Accordion>

  <Accordion title="Red pill — unresolved">
    Something about this reference can't be matched to a real app or skill. Click **Ask Agent to Fix** and Aiden will repair it.
  </Accordion>
</AccordionGroup>

You don't add integrations by hand — Aiden picks them based on your Goal and your Steps. Change the plan and the pills update themselves.

***

## Connecting an App

The first time a playbook needs an app, you'll be asked to sign in.

<Steps>
  <Step title="Click the integration pill">
    An orange pill in the editor, or the **Connect** button on the Capabilities page, will open a standard sign-in window.
  </Step>

  <Step title="Sign in with your account">
    Use the account you want the playbook to act from. This is a normal OAuth flow from the provider.
  </Step>

  <Step title="Approve access">
    Grant the permissions the screen asks for. Aident asks for what your current playbook or future actions may need.
  </Step>

  <Step title="You're done">
    The pill turns white and the playbook can use the app right away.
  </Step>
</Steps>

<Info>
  Aident never sees your password. Sign-in goes straight to the provider; Aident only receives a token you can revoke at any time.
</Info>

***

## The Capabilities Page

Open **Capabilities** from the left sidebar. The header reads "Capabilities" and shows the integrations catalog. Most connection work happens on the **Integrations** tab; depending on your account role, you may also see admin-oriented tabs.

<Tabs>
  <Tab title="Integrations">
    Browse apps Aident can connect to, search the catalog, and use **Connect** or **Disconnect** on each integration.
  </Tab>

  <Tab title="Vault">
    Admin users can manage API-key style credentials for integrations that use stored secrets instead of an OAuth sign-in.
  </Tab>

  <Tab title="Audit">
    Review recent capability usage.
  </Tab>
</Tabs>

The **Connections** page is separate. It manages MCP access, reusable skills, channels, and sandbox-related setup.

***

## Managing Connections

<AccordionGroup>
  <Accordion title="Reconnect an app">
    If a connection expires, the pill turns orange in the editor. Click it to sign in again and you're back in business.
  </Accordion>

  <Accordion title="Disconnect an app">
    Go to **Capabilities** and click **Disconnect** on the integration you want to remove. Any playbook that uses it will need to be reconnected before it runs again.
  </Accordion>

  <Accordion title="Resync a channel">
    Open **Connections** and use the channel controls if a bot's state looks out of date.
  </Accordion>
</AccordionGroup>

<Warning>
  Disconnecting affects every playbook that relies on the app. Make sure no scheduled runs depend on it before you revoke access.
</Warning>

***

## What Aident Supports

Aident has a growing catalog across communication (Gmail, Slack, Microsoft Teams, Discord, Telegram), productivity (Google Drive, Docs, Sheets, Calendar, Notion, Lark, Box), developer tools (GitHub), AI and media (Fal AI, Gladia), search (Exa, SerpAPI, Firecrawl), social (X), and storage (Dropbox) — among others.

<Tip>
  Open **Capabilities** in the sidebar to see the full, up-to-date integration catalog. That's the source of truth, not any static table in the docs.
</Tip>

***

## Security

* Sign-in goes directly to the provider over OAuth — Aident never sees your password.
* Aident only asks for the permissions your playbook actually needs.
* You can disconnect any integration from the **Capabilities** page at any time.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Playbooks" icon="book" href="/documentation/playbooks">
    See where integration pills live on the editor canvas
  </Card>

  <Card title="Skills" icon="bolt" href="/documentation/skills">
    Learn how steps reference actions that use your integrations
  </Card>
</CardGroup>
