Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

next
mdx 125 lines 3.88 KB
Raw
1 ---
2 title: Claude Code Plugin
3 description: Act on %TOOLKIT_COUNT% 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** lets Claude act on %TOOLKIT_COUNT% 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 Using Codex? Follow the [Codex setup](/docs/agent-plugins#configure-one-agent). If you explicitly want MCP in Cursor, Claude Desktop, or another MCP client, use [Composio Connect](/docs/composio-connect).
11 </Callout>
12
13 ## Install
14
15 <Steps>
16 <Step>
17 <StepTitle>Add the Composio marketplace</StepTitle>
18
19 In Claude Code, run:
20
21 ```bash
22 /plugin marketplace add ComposioHQ/composio-plugin-cc
23 ```
24
25 </Step>
26 <Step>
27 <StepTitle>Install the plugin</StepTitle>
28
29 ```bash
30 /plugin install composio@composio
31 ```
32
33 Restart Claude Code (or run `/reload-plugins`) when prompted.
34
35 </Step>
36 <Step>
37 <StepTitle>Ask Claude to do something</StepTitle>
38
39 Try: *"Star `composiohq/composio` on GitHub."*
40
41 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.
42
43 </Step>
44 </Steps>
45
46 <Callout>
47 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`.
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
60 **Run cross-app workflows** — reads feed the write:
61
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
67 **Fan out reads, then summarize:**
68
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
74 ## Connecting apps
75
76 Apps connect on demand — the first task that needs one hands you an OAuth link. To connect an app ahead of time:
77
78 ```bash
79 /composio-connect linear
80 ```
81
82 Works for any of the %TOOLKIT_COUNT% supported apps — `slack`, `github`, `gmail`, `notion`, `linear`, `hubspot`, and more.
83
84 ## Team setup
85
86 To pre-install the plugin for everyone on your team, add this to your project's `.claude/settings.json`:
87
88 ```json title=".claude/settings.json"
89 {
90 "extraKnownMarketplaces": {
91 "composio": {
92 "source": {
93 "source": "github",
94 "repo": "ComposioHQ/composio-plugin-cc"
95 }
96 }
97 },
98 "enabledPlugins": {
99 "composio@composio": true
100 }
101 }
102 ```
103
104 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.
105
106 ## Updating
107
108 To pull the latest plugin release:
109
110 ```bash
111 /plugin marketplace update composio
112 /reload-plugins
113 ```
114
115 New capabilities usually ship in the Composio CLI itself — `composio upgrade` picks them up without touching the plugin.
116
117 ## Source code
118
119 The plugin is open source: [ComposioHQ/composio-plugin-cc](https://github.com/ComposioHQ/composio-plugin-cc). Issues and PRs welcome.
120
121 ## Troubleshooting
122
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
125 For auth or connection issues, see the [CLI reference](/docs/cli) or run `composio --help`.