---
title: Connectors
description: Give your agents your apps, like Gmail, Slack, Notion or Linear, with your say before they change anything.
---

**Connectors** link a workspace to your apps, so you can ask an agent to read your mail or file a Linear issue. Apps come through Composio (Gmail, Google Calendar, Slack, Notion, GitHub, Linear, Outlook and many more), or through **Executor**, which runs on your computer and can add any remote MCP server.

:::note
Connectors are experimental. Turn on **Enable Experimental Features** (Settings > General > Advanced) to see **Settings > Connectors**.
:::

## Set it up

1. **Sign in to Composio**

    Open **Settings > Connectors** and sign the workspace in. It opens your browser. From a terminal: `ghostex connectors sign-in`.

2. **Connect your apps**

    Connect each app you want, for example Gmail: `ghostex connectors connect gmail`. For Discord, connect `discordbot` so agents can read a server's channels.

3. **Ask an agent**

    Every Claude and Codex session that starts or resumes afterwards gets the workspace's apps. Just ask: "summarize my unread mail from today".

Each [workspace](/views/work) has its own sign-in and its own apps, so work apps stay in your Work workspace. Without Workspaces, everything belongs to Personal.

## Nothing changes without you

Reading runs at once. Before an agent sends, posts, creates, changes or deletes anything, its chat shows a card: **Approve**, **Always allow** (stop asking for that tool in this workspace) or **Deny**. The session shows it's waiting for you in the sidebar.

Change the rules in Settings > Connectors, or with `ghostex connectors rule <tool|all> <ask|allow|never|default>`. For example, `rule all never` lets agents in that workspace only read.

## Work accounts for gh and gws

A workspace can have its own **GitHub CLI** (`gh`) and **Google Workspace CLI** (`gws`) sign-in, so agents in your Work workspace act as your work accounts while your own terminal keeps your usual one: `ghostex connectors gh sign-in` (or `gws`).

## Commands

| Command                                            | What it does                                          |
| -------------------------------------------------- | ----------------------------------------------------- |
| `ghostex connectors status`                        | Every workspace's sign-in and apps.                   |
| `ghostex connectors connect <app>`                 | Connect an app.                                       |
| `ghostex connectors rules`                         | What happens when an agent wants to change something. |
| `ghostex connectors executor enable`               | Turn on Executor for a workspace.                     |
| `ghostex connectors executor add-mcp <name> <url>` | Add a remote MCP server through Executor.             |
| `ghostex connectors help`                          | Every command.                                        |

Every command takes `--workspace <name>`. To turn Connectors off, switch it off in **Settings > Extensions > Store**; your sign-ins are kept.

:::tip[Ask Ghostex]
Try "Connect my Gmail so agents can read it."
:::