# Integrations

> Connect ready-made apps such as Notion, Canva and Linear for the company, a Space or only yourself, and see who can use each one.

Source: https://docs.whorl.work/integrations

The **Integrations** page lists the apps your agents can work in. Press **Connect** beside an app, sign in, and agents can use it as you. The page is in three places, and where you connect an app decides who can use it.

| Where                                 | Who can use the apps                     | Who can connect them |
| ------------------------------------- | ---------------------------------------- | -------------------- |
| **Settings → Company → Integrations** | Everyone at your company, in every Space | Owners and admins    |
| A Space's **Integrations** tab        | The people in that Space, and only there | The Space's owners   |
| **Settings → Account → Integrations** | Only you, in every Space you work in     | You                  |

Someone who cannot connect apps in a place still sees what is connected there. If nothing is, the page says so and tells them an owner can connect one.

## Connect an app

1. Open the Integrations page for the place the app should be available.
2. Under **Add an app**, choose **Connect** beside Canva, Notion, Linear, monday.com, Vercel, Granola or Sentry.
3. Sign in to the app in the page that opens. When you come back, the app is under **Connected**.

An app marked **Needs sign-in** is connected but still waits for you. Open it and sign in. **Needs a key** and **Needs approval** mean the same: open the app and follow what its page says.

## Apps from your company

In a Space and in your own settings, a group named after your company lists what the company connected for everyone. You do not add those again. Microsoft 365 stays on the company page. See [Microsoft 365](/microsoft-365).

## GitHub

On the same three pages, a **GitHub** card sits above the apps. It lets agents work in your GitHub repositories as you.

1. Press **Sign in with GitHub**. You sign in once, and the card then says **Signed in as** and your GitHub name. The **...** beside it has **Sign out of GitHub**.
2. Press **Connect GitHub** and choose the account and repositories Whorl can reach. When you come back, the account is listed with its repositories. A padlock marks a private one.
3. If an account already has Whorl installed, the card offers it with an **Add** button, so you do not install it again.

Whoever can change the page sees **Connect GitHub**, **Add** and, in each account's **...** menu, **Remove**. Removing asks first. Someone who cannot change a place still sees what is set up there and can sign in. In a Space and in your own settings, accounts the company set up appear in the card under **From** and the company's name, and you can only read them there.

When GitHub cannot be reached, an account shows **GitHub can't be reached right now** in place of its repositories. Try again in a moment.

Agents use GitHub as the person who sent the message. On their own, they use it only in your Personal Space. In a Company or shared Space they wait for someone's message.

## An app that is not listed

**Another app** adds one with a name and the address its maker gives you. See [Tools, MCP servers and connectors](/agents/tools).

## Each person signs in

Agents act as each person, so each person signs in to an app themselves. An agent never reaches more than the person it works for can.

## Related

- [Tools, MCP servers and connectors](/agents/tools)
- [Microsoft 365](/microsoft-365)
- [Spaces](/spaces)