> ## 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.

# Claude Code Plugin

> Act on 1,000+ apps from Claude Code — Slack, GitHub, Gmail, Notion, Linear, and more — with fully managed OAuth. Installs in two commands.

The **Composio plugin for Claude Code** lets Claude act on 1,000+ apps — send the Slack message, open the Linear issue, check your calendar, draft the email. Your agent decides what to do; Composio handles the rest: OAuth, permissions, and finding the right tool for each task. No API keys, no config files.

> [!NOTE]
>
> Using Codex? Follow the [Codex setup](https://composio-preview.mintlify.site/docs/agent-plugins.md#configure-one-agent). If you explicitly want MCP in Cursor, Claude Desktop, or another MCP client, use [Composio Connect](https://composio-preview.mintlify.site/docs/composio-connect.md).

## Install

**1. Add the Composio marketplace**

In Claude Code, run:

```bash theme={null}
/plugin marketplace add ComposioHQ/composio-plugin-cc
```

**2. Install the plugin**

```bash theme={null}
/plugin install composio@composio
```

Restart Claude Code (or run `/reload-plugins`) when prompted.

**3. Ask Claude to do something**

Try: *"Star `composiohq/composio` on GitHub."*

The first time, Claude installs the Composio CLI if it's missing, signs you in with `composio login`, and gives you an OAuth link for GitHub. Approve it in your browser and Claude runs the action.

> [!NOTE]
>
> Prefer to set things up ahead of time? Run `curl -fsSL https://composio.dev/install | sh` to install the CLI and configure your shell, then open a new terminal and run `composio login`.

## What you can do

Naming the app in your prompt keeps tool search scoped and the run reliable.

**Act on any connected app:**

```text theme={null}
What's on my Google Calendar for tomorrow? Add an event for lunch at 12PM.
```

**Run cross-app workflows** — reads feed the write:

```text theme={null}
Take the latest merged PR in acme/app, open a Linear issue summarizing it,
and post the issue link to #eng in Slack.
```

**Fan out reads, then summarize:**

```text theme={null}
In parallel, fetch my last 10 Gmail emails, my open Linear issues, and today's
Google Calendar events. Redact personal info, then give me a concise summary.
```

## Connecting apps

Apps connect on demand — the first task that needs one hands you an OAuth link. To connect an app ahead of time:

```bash theme={null}
/composio-connect linear
```

Works for any of the 1,000+ supported apps — `slack`, `github`, `gmail`, `notion`, `linear`, `hubspot`, and more.

## Team setup

To pre-install the plugin for everyone on your team, add this to your project's `.claude/settings.json`:

```json .claude/settings.json theme={null}
{
  "extraKnownMarketplaces": {
    "composio": {
      "source": {
        "source": "github",
        "repo": "ComposioHQ/composio-plugin-cc"
      }
    }
  },
  "enabledPlugins": {
    "composio@composio": true
  }
}
```

Anyone who clones the repo and opens it in Claude Code will be prompted to enable the plugin. See the Claude Code [plugin scopes](https://docs.claude.com/en/docs/claude-code/plugins-reference#plugin-installation-scopes) reference for `user` vs `project` vs `local` scope behavior.

## Updating

To pull the latest plugin release:

```bash theme={null}
/plugin marketplace update composio
/reload-plugins
```

New capabilities usually ship in the Composio CLI itself — `composio upgrade` picks them up without touching the plugin.

## Source code

The plugin is open source: [ComposioHQ/composio-plugin-cc](https://github.com/ComposioHQ/composio-plugin-cc). Issues and PRs welcome.

## Troubleshooting

For plugin issues — install errors, marketplace not updating — see the [Claude Code plugin troubleshooting docs](https://docs.claude.com/en/docs/claude-code/plugins-reference#common-issues).

For auth or connection issues, see the [CLI reference](https://composio-preview.mintlify.site/docs/cli.md) or run `composio --help`.
