> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Composio Connect

> Connect Composio to an existing MCP client without using the SDK

Use Composio Connect when you already have an MCP-compatible client and want the shared Composio MCP URL, without creating an SDK session. Connect it to `https://connect.composio.dev/mcp`.

If you use Codex or Claude Code and did not explicitly choose MCP, install the native [Composio agent plugin](https://composio-preview.mintlify.site/docs/agent-plugins.md) instead. The plugin uses the Composio CLI and is the shortest path for those agents.

If you are building an application, start with the [SDK Quickstart](https://composio-preview.mintlify.site/docs/quickstart.md) or create a [session MCP endpoint](https://composio-preview.mintlify.site/docs/sessions-via-mcp.md) instead.

## How Composio Connect works

Composio Connect is an MCP server at `https://connect.composio.dev/mcp` that gives your AI agent access to 1000+ apps, including Gmail, Notion, Slack, GitHub, Linear, HubSpot, and Strava, through a single connection.

Rather than exposing every app tool directly, Composio exposes **7 meta-tools** that let the agent discover what's available, authorize apps on demand, and execute tools across apps in parallel. The first time your agent needs an app, Composio generates an OAuth link you approve in your browser; after that the connection persists across sessions. See [Available MCP tools](#available-mcp-tools) for the full list.

To get started, pick your client below.

> [tab] Claude Code
>
> **1. Ask Claude Code to install Composio**
>
> Paste this prompt into Claude Code:
>
> ```text theme={null}
> Install the Composio CLI: curl -fsSL https://composio.dev/install | sh, then run composio login.
> ```

> [tab] Claude Cowork (Claude Desktop)
>
> **1. Open the Connectors menu**
>
> Click the **+** button in the message box, then choose **Connectors > Add connector > Add custom connector**.
>
> <video controls src="https://mintcdn.com/composio-preview/11RkPhDhzt1wdr6a/videos/onboarding/claude-desktop-open-connectors.mp4?fit=max&auto=format&n=11RkPhDhzt1wdr6a&q=85&s=d145acda3ace57a54dbdcd41670f3381" poster="/videos/onboarding/claude-desktop-open-connectors-poster.jpg" alt="Opening Claude's Connectors menu" />
>
> Opening Claude's Connectors menu
>
> **2. Add the Composio MCP server**
>
> Name it **Composio**, paste `https://connect.composio.dev/mcp`, then click **Add**.
>
> <video controls src="https://mintcdn.com/composio-preview/11RkPhDhzt1wdr6a/videos/onboarding/claude-desktop-add-connector.mp4?fit=max&auto=format&n=11RkPhDhzt1wdr6a&q=85&s=8654038988ea51aaf3fc346967cf706e" poster="/videos/onboarding/claude-desktop-add-connector-poster.jpg" alt="Adding the Composio server" />
>
> Adding the Composio server
>
> **3. Authorize in your browser**
>
> Claude opens a browser window. Sign in to authorize Composio.
>
> <video controls src="https://mintcdn.com/composio-preview/11RkPhDhzt1wdr6a/videos/onboarding/claude-desktop-authorize.mp4?fit=max&auto=format&n=11RkPhDhzt1wdr6a&q=85&s=b62aa016050b0ea404b27bb8cbc53144" poster="/videos/onboarding/claude-desktop-authorize-poster.jpg" alt="Authorizing Composio" />
>
> Authorizing Composio

> [tab] ChatGPT
>
> **1. Enable Developer mode**
>
> In ChatGPT, open **Settings > Security and login**, then turn on **Developer mode**. This requires ChatGPT Plus, Pro, Business, Enterprise, or Edu.
>
> <video controls src="https://mintcdn.com/composio-preview/11RkPhDhzt1wdr6a/videos/onboarding/chatgpt-developer-mode.mp4?fit=max&auto=format&n=11RkPhDhzt1wdr6a&q=85&s=e156c9e4098d8a1b7f9e73ff56644e37" poster="/videos/onboarding/chatgpt-developer-mode-poster.jpg" alt="Enabling Developer mode" />
>
> Enabling Developer mode
>
> **2. Add the MCP server**
>
> On the **Plugins** page, click **+**, choose **New Plugin**, paste `https://connect.composio.dev/mcp` into **Server URL**, then click **Create**.
>
> <video controls src="https://mintcdn.com/composio-preview/11RkPhDhzt1wdr6a/videos/onboarding/chatgpt-create-connector.mp4?fit=max&auto=format&n=11RkPhDhzt1wdr6a&q=85&s=0f7966e257d9855cc863819b520a9e6e" poster="/videos/onboarding/chatgpt-create-connector-poster.jpg" alt="Creating the Composio plugin" />
>
> Creating the Composio plugin
>
> **3. Authorize in your browser**
>
> Sign in in the browser window ChatGPT opens.
>
> <video controls src="https://mintcdn.com/composio-preview/11RkPhDhzt1wdr6a/videos/onboarding/chatgpt-authorize.mp4?fit=max&auto=format&n=11RkPhDhzt1wdr6a&q=85&s=f8f16b802c02ef054ecea77ac010db03" poster="/videos/onboarding/chatgpt-authorize-poster.jpg" alt="Authorizing Composio" />
>
> Authorizing Composio
>
> **4. Enable Composio in a chat**
>
> For each new chat, click **+**, choose **More**, then select **Composio** to enable its tools.

> [tab] Cursor
>
> **1. Install the Composio plugin**
>
> Open the [Composio plugin in the Cursor marketplace](https://cursor.com/marketplace/composio), click **Install Composio Plugin for Cursor**, and authorize in your browser.
>
> <video controls src="https://mintcdn.com/composio-preview/11RkPhDhzt1wdr6a/videos/cursor-plugin-installation.mp4?fit=max&auto=format&n=11RkPhDhzt1wdr6a&q=85&s=b512bd602afe7e8354460acac87e2f5a" poster="/videos/cursor-plugin-installation-poster.jpg" alt="Installing the Cursor plugin" />
>
> Installing the Cursor plugin

> [tab] Muse
>
> Muse builds the connector from a chat message, so there is no settings form. Use `https://connect.composio.dev/mcp` as the URL, not a `backend.composio.dev` URL.
>
> **1. Ask Muse to connect to Composio**
>
> Start a new Muse chat and send this message:
>
> ```text theme={null}
> Create a Custom Connector for the Composio remote MCP server and connect to it:
> - Name: Composio
> - Transport: remote streamable HTTP
> - URL: https://connect.composio.dev/mcp
> - Auth: API key sent in the x-consumer-api-key header
> Use exactly this URL. Don't look it up in the Composio docs or swap in another host such as backend.composio.dev.
> Open the secure credentials store so I can enter the API key there, not in this chat. Then list its tools to confirm the connection works.
> ```
>
> **2. Add your API key in the secure credentials store**
>
> Copy your consumer API key from the AI Clients setup in the Composio dashboard. Don't paste it into the chat. Tap the button Muse shows to open **Add custom connector**, paste the key, then tap **Add**. Muse lists the Composio tools once it connects.

> [tab] OpenClaw
>
> **1. Ask OpenClaw to install Composio**
>
> ```text theme={null}
> Install the Composio CLI: curl -fsSL https://composio.dev/install | sh, then run composio login.
> ```

> [tab] Atomic Agent
>
> **1. Add your Composio API key**
>
> Open the **Integrations** tab in the TUI and select **Composio**, or add the key to `~/.atomic-agent/.env`:
>
> ```text theme={null}
> COMPOSIO_API_KEY=your-api-key
> ```
>
> **2. Restart the agent**
>
> Composio tools are registered at startup and appear as `mcp.composio.*`. Ask the agent for something that lives in one of your apps and it will search for the right tool, then prompt you to authorize the app on first use.

> [tab] Hermes
>
> **1. Ask Hermes to install Composio**
>
> ```text theme={null}
> Install the Composio CLI: curl -fsSL https://composio.dev/install | sh, then run composio login.
> ```

> [tab] Atomic Bot
>
> Atomic Bot holds the Composio connection for each agent it runs, so there is no MCP URL to paste here. You pick the apps in its own Connectors screen instead.
>
> **1. Open Connectors for your agent**
>
> In [Atomic Bot](https://atomicbot.ai/cloud?utm_source=composio\&utm_medium=docs\&utm_campaign=composio_connect), open the agent you want to connect and go to **Connectors**. No instance yet? Pick an agent and it is running in about a minute.
>
> **2. Connect the apps it needs**
>
> Find the app and press **Connect**. Composio runs the authorization, and the connected account belongs to that agent. Its tools are available in the chat right away.

> [tab] Notion
>
> **1. Create a custom agent**
>
> In Notion's AI agent builder, click **Create Blank**.
>
> **2. Add the Composio connection**
>
> Choose **Add Connection > Custom MCP**, enter `https://connect.composio.dev/mcp`, name the connection **Composio**, and complete the OAuth authorization in your browser.

> [tab] Codex
>
> **1. Ask Codex to install Composio**
>
> ```text theme={null}
> Install the Composio CLI: curl -fsSL https://composio.dev/install | sh, then run composio login.
> ```

> [tab] Warp
>
> **1. Install from the Warp marketplace**
>
> Open `warp://settings/mcp?autoinstall=composio` in Warp to install the MCP server, then authorize in your browser. If Warp does not open, add it under **Settings > Agents > MCP servers**.

> [tab] Grok
>
> **1. Open Grok connectors**
>
> Go to [Grok Connectors](https://grok.com/connectors), click **New Connector**, then choose **Custom**. Custom connectors require a paid tier.
>
> **2. Add Composio and authorize**
>
> Paste `https://connect.composio.dev/mcp`, save, and authorize Composio in the sign-in window.

> [tab] Gemini CLI
>
> **1. Ask Gemini CLI to install Composio**
>
> ```text theme={null}
> Install the Composio CLI: curl -fsSL https://composio.dev/install | sh, then run composio login.
> ```

> [tab] VS Code
>
> **1. Install from the GitHub MCP registry**
>
> Open [Composio in the GitHub MCP registry](https://github.com/mcp/ComposioHQ/composio), click **Install in VS Code**, and authorize when prompted.

> [tab] Devin Desktop (Windsurf)
>
> **1. Install Composio in one click**
>
> Open `windsurf://windsurf-mcp-registry?serverName=composio` in Devin Desktop to install Composio. Your team needs MCP access enabled.
>
> **2. Or configure it manually**
>
> Open `~/.codeium/windsurf/mcp_config.json` or **Settings > MCP Configuration**, then add:
>
> ```json mcp_config.json theme={null}
> {
>   "mcpServers": {
>     "composio": {
>       "serverUrl": "https://connect.composio.dev/mcp"
>     }
>   }
> }
> ```
>
> Restart Devin Desktop and click **Authorize** next to Composio.

> [tab] Antigravity
>
> **1. Open your MCP config**
>
> In Antigravity, choose **Settings > Customizations > Open MCP Config**.
>
> **2. Add the Composio server**
>
> Antigravity uses `serverUrl` for remote HTTP servers:
>
> ```json mcp_config.json theme={null}
> {
>   "mcpServers": {
>     "composio": {
>       "serverUrl": "https://connect.composio.dev/mcp",
>       "headers": {
>         "x-consumer-api-key": "YOUR_CONSUMER_KEY"
>       }
>     }
>   }
> }
> ```
>
> Save the file, then refresh the **Installed MCP Servers** list.

> [tab] OpenAI Agent Builder (Agent Builder)
>
> **1. Open Agent Builder**
>
> Open [OpenAI Agent Builder](https://platform.openai.com/agent-builder) and create a new agent.
>
> **2. Add Composio as an MCP server**
>
> In the sidebar, choose **MCP > + Server**. Paste `https://connect.composio.dev/mcp`, choose **Custom headers**, then set `x-consumer-api-key` to `YOUR_CONSUMER_KEY`.

> [tab] n8n
>
> **1. Add an MCP Client node**
>
> In your n8n workflow, add an **MCP Client** node or MCP Client Tool sub-node.
>
> **2. Configure Composio**
>
> Set the connection type to **HTTP Streamable** and URL to `https://connect.composio.dev/mcp`. Select **Header Auth**, create a credential with header name `x-consumer-api-key`, and use `YOUR_CONSUMER_KEY` as its value.

> [tab] Generic MCP URL
>
> **1. Add the Composio server**
>
> Use `https://connect.composio.dev/mcp` with streamable HTTP and this header:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "composio": {
>       "url": "https://connect.composio.dev/mcp",
>       "headers": {
>         "x-consumer-api-key": "YOUR_CONSUMER_KEY"
>       }
>     }
>   }
> }
> ```

## Connect your apps

Your agent will prompt you to connect apps when needed. If you want to connect an app ahead of time, ask your agent to start the connection and complete the OAuth flow it opens.

## Available MCP tools

Composio Connect exposes 7 meta-tools that orchestrate access to all supported apps. Your agent uses these to discover, connect, and execute upstream tools — you don't need to call them directly.

* **`COMPOSIO_SEARCH_TOOLS`** — Search the Composio catalog and return relevant tools for a user request, along with a suggested execution plan.
* **`COMPOSIO_GET_TOOL_SCHEMAS`** — Fetch full input schemas for tool slugs returned by search.
* **`COMPOSIO_MULTI_EXECUTE_TOOL`** — Execute one or more discovered tools in parallel across connected apps (up to 50 per call).
* **`COMPOSIO_MANAGE_CONNECTIONS`** — Create, list, rename, or remove OAuth connections to upstream apps.
* **`COMPOSIO_WAIT_FOR_CONNECTIONS`** — Wait for a user to complete an OAuth flow before the agent continues.
* **`COMPOSIO_REMOTE_WORKBENCH`** — Run Python in a remote sandbox for bulk operations or processing large tool responses.
* **`COMPOSIO_REMOTE_BASH_TOOL`** — Run bash in a remote sandbox for file processing and large data handling.

## Troubleshooting

### Tools aren't appearing in my agent

1. Confirm the MCP server is connected. In Claude Desktop, go to **Settings > Connectors** and check that Composio shows a `CUSTOM` badge. In Claude Code, run `/mcp` and confirm Composio is enabled.
2. Clear the connector cache. In Claude Desktop: click the **⋮** next to Composio and select **Clear cache**.
3. If the issue persists, disconnect and re-add the connector:
   * **Claude Desktop** — click **⋮ > Disconnect**, then **Remove**. Re-add via **Add custom connector**.
   * **Claude Code** — re-run the setup command from the Claude Code section above.

### The OAuth link expired or didn't open

OAuth links are short-lived. If the browser window doesn't open or the link has expired, ask your agent to retry the action — Composio will generate a fresh link.

### An app action is failing with an auth error

1. Ask your agent to inspect the app connection.
2. If the connection is unhealthy, disconnect and reconnect it when prompted.
3. Retry the action.

### I want to remove or reconnect an app

Ask your agent to manage the connection. It can prompt you to disconnect, delete, or re-authorize an app.

### I still need help

Reach out at [support@composio.dev](mailto:support@composio.dev) or join the [Composio Discord](https://discord.com/invite/cNruWaAhQk).
