@devries-cameron20 / composio-1 / commits / aacbc97a1
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(claude-code-plugin): add page for Claude Code plugin install path

Adds /docs/claude-code-plugin documenting the marketplace install of composio-mcp via /plugin marketplace add ComposioHQ/composio-plugin-cc. Needed as the public homepage URL for the Anthropic plugin marketplace submission form (claude.ai/settings/plugins/submit), which requires a docs link before approval. Complements the existing /docs/composio-connect page, which covers the API-key MCP path; this one covers the OAuth-based plugin path and lists the bundled skills (composio-mcp, onboarding, company-activity-summary, prefer-composio). Sidebar entry added under "Get Started" between cli and providers. Co-authored-by: Cursor <cursoragent@cursor.com>

Shawn Esquivel committed May 3, 2026 at 16:52 UTC aacbc97a19fdc29030f24d8d091021e9f7c37c38
2 files changed +111
docs/content/docs/claude-code-plugin.mdx new
+110
@@ -0,0 +1,110 @@
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]
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.
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).
11 +</Callout>
12 +
13 +## What you get
14 +
15 +The plugin ships two things together:
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.
23 +
24 +## Install
25 +
26 +<Steps>
27 +<Step>
28 +<StepTitle>Add the Composio marketplace</StepTitle>
29 +
30 +In Claude Code, run:
31 +
32 +```bash
33 +/plugin marketplace add ComposioHQ/composio-plugin-cc
34 +```
35 +
36 +This registers the catalog. No plugins are installed yet.
37 +
38 +</Step>
39 +<Step>
40 +<StepTitle>Install the Composio plugin</StepTitle>
41 +
42 +```bash
43 +/plugin install composio-mcp@composio
44 +```
45 +
46 +Restart Claude Code (or run `/reload-plugins`) when prompted.
47 +
48 +</Step>
49 +<Step>
50 +<StepTitle>Connect your first app</StepTitle>
51 +
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.
53 +
54 +</Step>
55 +</Steps>
56 +
57 +## Team setup
58 +
59 +To pre-install the plugin for everyone on your team, add this to your project's `.claude/settings.json`:
60 +
61 +```json title=".claude/settings.json"
62 +{
63 + "extraKnownMarketplaces": {
64 + "composio": {
65 + "source": {
66 + "source": "github",
67 + "repo": "ComposioHQ/composio-plugin-cc"
68 + }
69 + }
70 + },
71 + "enabledPlugins": {
72 + "composio-mcp@composio": true
73 + }
74 +}
75 +```
76 +
77 +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.
78 +
79 +## Updating
80 +
81 +The plugin is versioned via the `version` field in its `plugin.json`. To pull the latest release:
82 +
83 +```bash
84 +/plugin marketplace update composio
85 +/reload-plugins
86 +```
87 +
88 +## How it differs from the API-key MCP setup
89 +
90 +Both paths give Claude Code access to the same Composio Connect MCP server and the same 1000+ apps. The differences:
91 +
92 +| | Plugin install | `claude mcp add` |
93 +|---|---|---|
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` |
99 +
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.
101 +
102 +## Source code
103 +
104 +The plugin is open source: [ComposioHQ/composio-plugin-cc](https://github.com/ComposioHQ/composio-plugin-cc). Issues and PRs welcome.
105 +
106 +## Troubleshooting
107 +
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).
109 +
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).
docs/content/docs/meta.json
+1
@@ -5,6 +5,7 @@
5 "quickstart",
6 "providers",
7 "cli",
8 + "claude-code-plugin",
9 "---Core Concepts---",
10 "how-composio-works",
11 "users-and-sessions",