# Composio setup instructions

Composio gives an AI client one connection to the apps you already use: Gmail, GitHub, Google Calendar, and hundreds more.

This page documents setup for every supported client. Follow the section for the client you're using. Clients that aren't listed are covered by **Other MCP clients**.

## Composio setup for CLI agents

Claude Code, Codex, Hermes, and OpenClaw all run in a terminal, so they reach Composio through the `composio` CLI. The steps are the same for each.

### Install the Composio CLI

Install the CLI:

```sh
curl -fsSL https://composio.dev/install | sh
```

Then sign in:

```sh
composio login
```

---

## Composio setup for Claude (Chat and Cowork)

Add Composio as a Custom Connector on the desktop or the web:

https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Composio&connectorUrl=https%3A%2F%2Fconnect.composio.dev%2Fmcp

The link opens the Add-connector modal with the fields prefilled. You must still review and confirm in the modal.

*Note* Composio is pending publication on the Claude marketplace, so for now please use a custom connector.

---

## Composio setup for Cursor

Install the Composio plugin for Cursor:

https://cursor.com/marketplace/composio

The link opens the page for the Composio plugin on the Cursor marketplace. You can then review and install from the marketplace page.

---

## Composio setup for VS Code/Github Co-pilot

Install Composio in VS Code from the GitHub MCP registry:

https://github.com/mcp/ComposioHQ/composio

The link opens the page for Composio on the GitHub MCP registry. You can then review and install from the registry page.

---

## Composio setup for Gemini CLI

```bash
gemini mcp add --scope user --transport http composio https://connect.composio.dev/mcp
```

---

## Other MCP clients

Any client that speaks MCP over streamable HTTP can reach Composio.

### Add the Composio MCP server

Add a server to the client's MCP configuration with:

- **Name:** composio
- **Transport:** HTTP (streamable HTTP)
- **URL:** https://connect.composio.dev/mcp

Most clients read an `mcp.json` shaped like this:

```json
{
  "mcpServers": {
    "composio": {
      "url": "https://connect.composio.dev/mcp"
    }
  }
}
```

Complete the OAuth sign-in when the client prompts for authentication.

Clients that don't support OAuth, check out the clients page for alternative ways to connect:

https://connect.composio.dev/~/org/connect/clients

---

## How to use Composio

Use the Composio search tool to explore your favourite apps.