@devries-cameron20 / composio-1 / commits / e54b215b1
Fork 0

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.