Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | --- |
| 2 | title: Agent plugins |
| 3 | description: Install Composio for Codex or Claude Code |
| 4 | keywords: [agent plugins, codex, claude code, cli, composio setup, skills] |
| 5 | --- |
| 6 | |
| 7 | Agent plugins let Codex and Claude Code use Composio from your current conversation. The plugin teaches your agent how to find tools, connect accounts, and run actions through the Composio CLI. |
| 8 | |
| 9 | ## Install the plugin |
| 10 | |
| 11 | Install the Composio CLI: |
| 12 | |
| 13 | ```bash |
| 14 | curl -fsSL https://composio.dev/install | sh |
| 15 | ``` |
| 16 | |
| 17 | Open a new terminal, sign in, and configure every supported agent on your machine: |
| 18 | |
| 19 | ```bash |
| 20 | composio login |
| 21 | composio setup --target auto |
| 22 | ``` |
| 23 | |
| 24 | `auto` detects Codex and Claude Code. If both are installed, it configures both. |
| 25 | |
| 26 | <Callout type="info" title="Running setup from an agent or script?"> |
| 27 | Setup asks before changing local files. Add `--yes` in a non-interactive shell: `composio setup --target auto --yes`. |
| 28 | </Callout> |
| 29 | |
| 30 | ## Try a task |
| 31 | |
| 32 | Ask Codex or Claude Code to work with one of your apps: |
| 33 | |
| 34 | - `List the open GitHub issues assigned to me.` |
| 35 | - `Summarize the unread Gmail messages I received today.` |
| 36 | - `Create a Linear issue from these release notes: ...` |
| 37 | |
| 38 | You do not need to know a tool slug or connection ID. The agent searches by task and selects a matching tool. If the toolkit is not connected, the agent starts `composio link` and gives you a Connect Link. Approve the connection, then ask the agent to continue. |
| 39 | |
| 40 | ## Configure one agent |
| 41 | |
| 42 | Use an explicit target when you only want to configure one agent. |
| 43 | |
| 44 | ### Codex |
| 45 | |
| 46 | ```bash |
| 47 | composio setup --target codex |
| 48 | ``` |
| 49 | |
| 50 | The Codex plugin bundles the Composio CLI skill. You can also install the plugin with Codex directly: |
| 51 | |
| 52 | ```bash |
| 53 | codex plugin marketplace add https://github.com/ComposioHQ/composio-plugin-openai.git --json |
| 54 | codex plugin add composio@composio --json |
| 55 | ``` |
| 56 | |
| 57 | The plugin source is available in [`ComposioHQ/composio-plugin-openai`](https://github.com/ComposioHQ/composio-plugin-openai). |
| 58 | |
| 59 | ### Claude Code |
| 60 | |
| 61 | ```bash |
| 62 | composio setup --target claude |
| 63 | ``` |
| 64 | |
| 65 | You can also install the plugin from Claude Code: |
| 66 | |
| 67 | ```bash |
| 68 | /plugin marketplace add ComposioHQ/composio-plugin-cc |
| 69 | /plugin install composio@composio |
| 70 | ``` |
| 71 | |
| 72 | See the [Claude Code plugin guide](/docs/claude-code-plugin) for team installation, updates, and troubleshooting. |
| 73 | |
| 74 | ## What the plugin uses |
| 75 | |
| 76 | Both plugins run the Composio CLI underneath. The agent uses `composio search` to find an unknown tool, `composio link` to connect an account, and `composio execute` to run a known tool. The same connections are available when you use the [CLI directly](/docs/cli). |
| 77 | |
| 78 | ## Install only the CLI skill |
| 79 | |
| 80 | The plugin includes a Composio CLI skill that teaches your agent how to search for and run tools. Codex receives it with the plugin, while `composio login` installs it for Claude Code by default. |
| 81 | |
| 82 | If you want the skill without the plugin, install it for your agent directly: |
| 83 | |
| 84 | ```bash |
| 85 | composio setup skill claude |
| 86 | composio setup skill codex |
| 87 | ``` |
| 88 | |
| 89 | ## Choose another setup |
| 90 | |
| 91 | <Cards> |
| 92 | <Card title="Build an agent" href="/docs/quickstart" description="Add Composio tools and authentication to your application." /> |
| 93 | <Card title="Use the CLI" href="/docs/cli" description="Search, connect, and run tools from your terminal." /> |
| 94 | <Card title="Connect over MCP" href="/docs/composio-connect" description="Add Composio to an existing MCP client." /> |
| 95 | </Cards> |