Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs: make the Claude Code plugin page benefit-first
Lead with what the plugin does (act on 1,000+ apps, cross-app workflows, managed OAuth) instead of how it is built. Drop the hook inventory, no-MCP disclaimers, and the comparison table. Correct the install story: the CLI is not a manual prerequisite — Claude installs it and walks through login and app OAuth on first use; manual setup stays as an optional note. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Kshitij Jhunjhunwala committed
Jul 16, 2026 at 12:57 UTC
e54b215b1f92367d33221ccd284092e6a0dc48d9
1 file changed
+44
-51
docs/content/docs/claude-code-plugin.mdx
+44
-51
@@ -1,25 +1,15 @@
1
---
2
title: Claude Code Plugin
3
-description: Install Composio in Claude Code as a plugin — just-in-time tool calls across 1000+ apps through the Composio CLI, with fully managed OAuth.
4
-keywords: [claude code, plugin, marketplace, cli, composio, oauth, mcp]
3
+description: Act on 1,000+ apps from Claude Code — Slack, GitHub, Gmail, Notion, Linear, and more — with fully managed OAuth. Installs in two commands.
4
+keywords: [claude code, plugin, marketplace, composio, oauth, cli, mcp]
5
---
6
7
-The **Composio plugin for Claude Code** is a thin, CLI-based plugin: all logic lives in the `composio` CLI binary. Instead of pre-loading a fixed toolset, Claude resolves the right tool just-in-time — `composio search "<task>"` then `composio execute` — across 1000+ apps. Authentication is fully managed OAuth; no API keys in your config.
7
+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.
8
9
<Callout type="info">
10
-Looking for the MCP-based setup — Cursor, Codex, Claude Desktop, or `claude mcp add`? See [Composio Connect](/docs/composio-connect).
10
+Using Cursor, Codex, Claude Desktop, or another MCP client? See [Composio Connect](/docs/composio-connect).
11
</Callout>
12
13
-## What you get
14
-
15
-The plugin itself is three small pieces; everything else lives in the CLI:
16
-
17
-- **SessionStart hook** — tells Claude that Composio is available, surfaces your auth status, and warms a cache of the top 50 toolkits.
18
-- **UserPromptSubmit hook** — when a prompt names an app from that cache, nudges Claude toward `composio search`. Silent otherwise.
19
-- **`/composio-connect <app>`** — slash command that connects a toolkit via managed OAuth (`composio link`).
20
-
21
-There is no bundled MCP server and no bundled skills. Running `composio login` installs the full `composio-cli` skill into `~/.claude/skills`, which gives Claude detailed guidance on searching, executing, linking, and scripting with the CLI.
22
-
13
## Install
14
15
<Steps>
@@ -32,11 +22,9 @@ In Claude Code, run:
22
/plugin marketplace add ComposioHQ/composio-plugin-cc
23
```
24
35
-This registers the catalog. No plugins are installed yet.
36
-
25
</Step>
26
<Step>
39
-<StepTitle>Install the Composio plugin</StepTitle>
27
+<StepTitle>Install the plugin</StepTitle>
28
29
```bash
30
/plugin install composio@composio
@@ -46,34 +34,52 @@ Restart Claude Code (or run `/reload-plugins`) when prompted.
34
35
</Step>
36
<Step>
49
-<StepTitle>Install the CLI and sign in</StepTitle>
37
+<StepTitle>Ask Claude to do something</StepTitle>
38
51
-If you don't have the `composio` CLI yet:
39
+Try: *"Star `composiohq/composio` on GitHub."*
40
53
-```bash
54
-curl -fsSL https://composio.dev/install | bash
55
-composio login
41
+On first use, Claude sets up everything it needs — it offers to install the Composio CLI if it's missing (behind the normal permission prompt), signs you in with `composio login`, and hands you an OAuth link to connect GitHub. Approve it in your browser and Claude runs the action. Connections persist, so next time it just runs.
42
+
43
+</Step>
44
+</Steps>
45
+
46
+<Callout>
47
+Prefer to set things up ahead of time? Run `curl -fsSL https://composio.dev/install | bash`, then `composio login`.
48
+</Callout>
49
+
50
+## What you can do
51
+
52
+Naming the app in your prompt keeps tool search scoped and the run reliable.
53
+
54
+**Act on any connected app:**
55
+
56
+```text
57
+What's on my Google Calendar for tomorrow? Add an event for lunch at 12PM.
58
```
59
58
-Logging in also installs the `composio-cli` skill automatically.
60
+**Run cross-app workflows** — reads feed the write:
61
60
-</Step>
61
-<Step>
62
-<StepTitle>Connect your first app</StepTitle>
62
+```text
63
+Take the latest merged PR in acme/app, open a Linear issue summarizing it,
64
+and post the issue link to #eng in Slack.
65
+```
66
64
-Run `/composio-connect github` (or any of 1000+ apps), or just ask Claude something that needs an external service — for example: *"Star `composiohq/composio` on GitHub"*. Claude searches for the tool, hands you an OAuth link if the app isn't connected yet, and executes the action. Subsequent runs reuse the same connection.
67
+**Fan out reads, then summarize:**
68
66
-</Step>
67
-</Steps>
69
+```text
70
+In parallel, fetch my last 10 Gmail emails, my open Linear issues, and today's
71
+Google Calendar events. Redact personal info, then give me a concise summary.
72
+```
73
69
-## How it works
74
+## Connecting apps
75
71
-The plugin keeps Claude reaching for Composio, then gets out of the way — the CLI does the work:
76
+Apps connect on demand — the first task that needs one hands you an OAuth link. To connect an app ahead of time:
77
73
-1. **Session start** — the hook injects a note that Composio is available, along with your auth status.
74
-2. **Prompt time** — if your prompt names a known app, a one-line nudge points Claude at meta-search.
75
-3. **Execution** — Claude runs `composio search "<task>"` to find the right tool, then `composio execute` with managed auth. `composio link <app>` connects anything not yet connected.
76
-4. **Multi-step work** — `composio run '<js>'` scripts several calls (parallel reads, then a write) in one pass.
78
+```bash
79
+/composio-connect linear
80
+```
81
+
82
+Works for any of the 1,000+ supported apps — `slack`, `github`, `gmail`, `notion`, `linear`, `hubspot`, and more.
83
84
## Team setup
85
@@ -106,20 +112,7 @@ To pull the latest plugin release:
112
/reload-plugins
113
```
114
109
-Because all logic lives in the CLI, most capability updates don't need a plugin change at all — `composio upgrade` is enough.
110
-
111
-## How it compares to the MCP-based setup
112
-
113
-Both paths reach the same 1000+ apps with managed OAuth. The differences:
114
-
115
-| | Plugin + CLI | Composio Connect (MCP) |
116
-|---|---|---|
117
-| Tool discovery | Just-in-time `composio search` → `composio execute` | 7 meta-tools over MCP |
118
-| Configuration | Two slash commands + `composio login`; no MCP config | MCP server entry per client |
119
-| Guidance for the agent | `composio-cli` skill installed on login | Tool descriptions only |
120
-| Clients | Claude Code | Claude Code, Cursor, Codex, Claude Desktop, and [more](/docs/composio-connect) |
121
-
122
-Pick the plugin in Claude Code. Pick [Composio Connect](/docs/composio-connect) when you need Composio in other MCP clients.
115
+New capabilities usually ship in the Composio CLI itself — `composio upgrade` picks them up without touching the plugin.
116
117
## Source code
118
@@ -127,6 +120,6 @@ The plugin is open source: [ComposioHQ/composio-plugin-cc](https://github.com/Co
120
121
## Troubleshooting
122
130
-For plugin-specific issues — install errors, marketplace not updating, hooks not firing — see the [Claude Code plugin troubleshooting docs](https://docs.claude.com/en/docs/claude-code/plugins-reference#common-issues).
123
+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).
124
132
-For CLI issues — auth, connections, tool execution — run `composio --help` or see the [CLI reference](/docs/cli). `composio whoami` checks your login state; `composio connections list` shows what's connected.
125
+For everything else — auth, connections, tool execution — run `composio --help` or see the [CLI reference](/docs/cli). `composio whoami` checks your login state; `composio connections list` shows what's connected.