@devries-cameron20 / composio Mirror · read-only / commits / 3b758a0e2
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.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 18:30 UTC

docs: rewrite Claude Code plugin page for the CLI-based plugin

The plugin was redesigned from an MCP-server bundle to a thin CLI-based plugin; the page still documented the old design — a nonexistent install command (composio-mcp@composio) and bundled skills that no longer exist. Rewrite the page around what actually ships: SessionStart/UserPromptSubmit hooks, the /composio-connect command, and the just-in-time search -> execute flow driven by the composio CLI. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Kshitij Jhunjhunwala committed Jul 16, 2026 at 12:44 UTC 3b758a0e295787105910bdac31744dc80a3fa287
1 file changed +48 -26
docs/content/docs/claude-code-plugin.mdx
+48 -26
@@ -1,25 +1,24 @@
1 ---
2 title: Claude Code Plugin
3 -description: Install Composio in Claude Code as a plugin — connect 1000+ apps with managed OAuth and ready-made skills.
4 -keywords: [claude code, plugin, marketplace, mcp, composio connect, skills]
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]
5 ---
6
7 -The **Composio plugin for Claude Code** bundles the Composio Connect MCP server with a set of opinionated skills, so Claude Code can search, connect, and act across 1000+ apps right after install. Authentication is fully managed — no API key handling, no manual MCP config.
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.
8
9 <Callout type="info">
10 -Looking for the API-key based MCP setup (or other clients like Cursor, Codex, Claude Desktop)? See [Composio Connect](/docs/composio-connect).
10 +Looking for the MCP-based setup — Cursor, Codex, Claude Desktop, or `claude mcp add`? See [Composio Connect](/docs/composio-connect).
11 </Callout>
12
13 ## What you get
14
15 -The plugin ships two things together:
15 +The plugin itself is three small pieces; everything else lives in the CLI:
16
17 -- **Composio Connect MCP server** — the same gateway documented in [Composio Connect](/docs/composio-connect), pre-configured. Auth is handled via in-flow OAuth, so you don't paste API keys into your config.
18 -- **Bundled skills** — pre-written prompts that show Claude how to use the MCP server effectively:
19 - - **`composio-mcp`** — reference for the 7 meta-tools (`COMPOSIO_SEARCH_TOOLS`, `COMPOSIO_MANAGE_CONNECTIONS`, etc.) and the recommended search → connect → execute flow.
20 - - **`onboarding`** — interactive setup that asks what you want to automate, recommends 2–4 apps, and walks you through connecting them.
21 - - **`company-activity-summary`** — cross-app activity summary across Slack, GitHub, Notion, Linear, Gmail, and more.
22 - - **`prefer-composio`** — routing skill that tells Claude to reach for Composio first whenever you paste an app URL or mention an external service, so you don't end up using less reliable native connectors.
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
23 ## Install
24
@@ -40,20 +39,42 @@ This registers the catalog. No plugins are installed yet.
39 <StepTitle>Install the Composio plugin</StepTitle>
40
41 ```bash
43 -/plugin install composio-mcp@composio
42 +/plugin install composio@composio
43 ```
44
45 Restart Claude Code (or run `/reload-plugins`) when prompted.
46
47 +</Step>
48 +<Step>
49 +<StepTitle>Install the CLI and sign in</StepTitle>
50 +
51 +If you don't have the `composio` CLI yet:
52 +
53 +```bash
54 +curl -fsSL https://composio.dev/install | bash
55 +composio login
56 +```
57 +
58 +Logging in also installs the `composio-cli` skill automatically.
59 +
60 </Step>
61 <Step>
62 <StepTitle>Connect your first app</StepTitle>
63
52 -Ask Claude something that needs an external service — for example: *"Star `composiohq/composio` on GitHub"* — and Claude will run the `onboarding` skill, walk you through connecting GitHub, and execute the action. Subsequent runs reuse the same connection.
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.
65
66 </Step>
67 </Steps>
68
69 +## How it works
70 +
71 +The plugin keeps Claude reaching for Composio, then gets out of the way — the CLI does the work:
72 +
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.
77 +
78 ## Team setup
79
80 To pre-install the plugin for everyone on your team, add this to your project's `.claude/settings.json`:
@@ -69,7 +90,7 @@ To pre-install the plugin for everyone on your team, add this to your project's
90 }
91 },
92 "enabledPlugins": {
72 - "composio-mcp@composio": true
93 + "composio@composio": true
94 }
95 }
96 ```
@@ -78,26 +99,27 @@ Anyone who clones the repo and opens it in Claude Code will be prompted to enabl
99
100 ## Updating
101
81 -The plugin is versioned via the `version` field in its `plugin.json`. To pull the latest release:
102 +To pull the latest plugin release:
103
104 ```bash
105 /plugin marketplace update composio
106 /reload-plugins
107 ```
108
88 -## How it differs from the API-key MCP setup
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
90 -Both paths give Claude Code access to the same Composio Connect MCP server and the same 1000+ apps. The differences:
113 +Both paths reach the same 1000+ apps with managed OAuth. The differences:
114
92 -| | Plugin install | `claude mcp add` |
115 +| | Plugin + CLI | Composio Connect (MCP) |
116 |---|---|---|
94 -| Setup steps | Two slash commands | One terminal command, requires copying an API key |
95 -| Auth | OAuth, no API key in your config | API key in `--header "x-consumer-api-key: ..."` |
96 -| Bundled skills | Yes (onboarding, routing, summaries) | No |
97 -| Discoverable in Claude Code marketplace | Yes | No |
98 -| Updates | `/plugin marketplace update composio` | Manual re-run of `claude mcp add` |
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
100 -Pick the plugin path if you want the fastest install and the bundled skills. Pick the `claude mcp add` path if you already have an API key and want a single-command setup script you can replicate across machines.
122 +Pick the plugin in Claude Code. Pick [Composio Connect](/docs/composio-connect) when you need Composio in other MCP clients.
123
124 ## Source code
125
@@ -105,6 +127,6 @@ The plugin is open source: [ComposioHQ/composio-plugin-cc](https://github.com/Co
127
128 ## Troubleshooting
129
108 -For tools-not-appearing, OAuth, and connection issues, see the [Composio Connect troubleshooting section](/docs/composio-connect#troubleshooting). The same checks apply to the plugin install (the underlying MCP server is identical).
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).
131
110 -For plugin-specific issues — install errors, marketplace not updating, skills not appearing — see the [Claude Code plugin troubleshooting docs](https://docs.claude.com/en/docs/claude-code/plugins-reference#common-issues).
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.