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

# Connectors: GitHub, Gmail and other apps

> Connectors let cloud sessions access services such as GitHub and Gmail as you. This page covers connecting, Gmail access levels, expired authorization and reconnecting, send confirmation, access management and disconnecting.

**Connectors** are third-party accounts you authorize AIHubMix Cloud to use. Once connected, cloud sessions can read and write these services as you, for example pulling GitHub repositories or searching Gmail. You authorize in the browser, with no token to enter.

Connectors cover accounts only. Agent capability extensions (plugins, MCP, Skills) are managed in [Plugins / MCP / Skills](https://docs.aihubmix.com/en/cloud/integrations/plugins-mcp-skills.md).

## Availability

Supported in the desktop app, web app and mobile web. Connectors are used only by cloud sessions and do not change the configuration on your device. Each connector connects one account.

## Where to find it

* **Settings › Integrations › Connectors**.
* When you create a project with **Import from GitHub** before GitHub is connected, click **Connect GitHub**.

## Connectors page

The page is divided into the groups **Code** (GitHub), **Email** (Gmail), **Connected apps** and **More apps**. Each row shows the name and status:

| Status | What you can do |
| - | - |
| Not connected | Click **Connect** |
| **● Connected · account** | Click **Manage** to view access permissions or disconnect |
| **● Authorization expired · account** | Click **Reconnect**. This usually means you revoked the authorization with the service |

The apps you can connect are those shown on the page.

## Connect an app

1. In the app's row, click **Connect** (for Gmail, choose an access level first, see below).
2. The browser opens the service's authorization page. Complete authorization there. If the page did not appear, click **Reopen browser**.
3. When done, return to AIHubMix Cloud. The app shows as connected.

If authorization is not completed, you see **Authorization not completed** with the reason. Click **Try again** or **Reconnect** to try once more. If it says another account is already connected, disconnect the existing connection first to switch accounts.

## GitHub

Once GitHub is authorized, you can import repositories as projects, pull code on the cloud server, push branches and open PRs, and sessions can read issues and PRs and search code. You choose which repositories and organizations are accessible on GitHub: click **Manage on GitHub** on the management page to add organizations or repositories.

After you disconnect GitHub, existing cloud environments can no longer pull code, push branches or open PRs. Files in the environments are kept.

## Gmail

Gmail has two access levels, and the agent **always** asks for your approval in the session before sending email. Each AIHubMix account can connect only one Google account.

| Level | What the agent can do |
| - | - |
| Read and send (default) | Search and read email, and send email for you |
| Send only | Only send email for you; it cannot search or read email |

* **Change access**: on the Gmail management page, click **Change granted access**, choose a new level, then click **Authorize with Google**.
* **Reconnect**: when authorization has expired, click **Reconnect**. This keeps the current level.
* If you chose **Read and send** but did not select the read permission on the Google authorization page, the Gmail row shows **Send only**, and the agent cannot read email yet. Click **Change granted access** to authorize again and select the read permission.

### Confirmation before sending

When the agent wants to send an email, it first shows **Confirm before sending** in the session, listing the sender, recipients, subject and body. Click **Send** or **Don't send**. The permission switches on the management page cannot skip this confirmation. Sending email through a connected Outlook account also requires confirmation.

## Connector management and access permissions

For any connected app, click **Manage** to open **Manage connector**, where you can see the connected account and access permissions, and **Disconnect**.

### Access permissions

The access permission list comes from the account's actual grants with the service, so the items differ by app and by account.

* Granted permissions can be turned off or on with a switch. Changes take effect only after saving succeeds. After you turn off a permission, sessions are blocked when they call that capability.
* Grayed-out items that cannot be toggled are permissions not granted for this account, not editable, or requiring reconnection. To expand access, authorize again.
* If saving or loading granted access fails, click **Reload access** and try again.

### Disconnect

1. On the management page, click **Disconnect**.
2. In the confirmation dialog, click **Disconnect**. After disconnecting, cloud tasks lose access to this app. You can reconnect any time.

If disconnecting fails, the connection is kept. Click **Reload access** and try again.

## Notes and limits

* Each connector connects only one account. To switch accounts, disconnect first.
* Connectors apply only to cloud sessions and do not change the configuration on your device.
* Which permissions you see, and whether you can change them, depends on the actual grants with the service.

## FAQ

### Do I need to enter a GitHub token?

No. All connectors use browser authorization.

### What if GitHub or Gmail shows "Authorization expired"?

This usually means the authorization was revoked with the service. Click **Reconnect** in the row. Gmail keeps the previous level.

### Does disconnecting GitHub delete my projects?

No. Files in cloud environments are kept. The environments can no longer pull code, push branches or open PRs.

### Will the agent send email without my approval?

No. Regardless of the level and permission switches, the agent asks you to confirm in the session before sending.

## Related

* [Plugins / MCP / Skills](https://docs.aihubmix.com/en/cloud/integrations/plugins-mcp-skills.md)
* [User intervention](https://docs.aihubmix.com/en/cloud/sessions/user-intervention.md)
* [Projects](https://docs.aihubmix.com/en/cloud/projects/projects.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.