Agent plugins

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.

Install the plugin

Install the Composio CLI:

curl -fsSL https://composio.dev/install | sh

Open a new terminal, sign in, and configure every supported agent on your machine:

composio login
composio setup --target auto

auto detects Codex and Claude Code. If both are installed, it configures both.

Try a task

Ask Codex or Claude Code to work with one of your apps:

• List the open GitHub issues assigned to me.
• Summarize the unread Gmail messages I received today.
• Create a Linear issue from these release notes: ...

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.

Configure one agent

Use an explicit target when you only want to configure one agent.

Codex

composio setup --target codex

The Codex plugin bundles the Composio CLI skill. You can also install the plugin with Codex directly:

codex plugin marketplace add https://github.com/ComposioHQ/composio-plugin-openai.git --json
codex plugin add composio@composio --json

The plugin source is available in ComposioHQ/composio-plugin-openai.

Claude Code

composio setup --target claude

You can also install the plugin from Claude Code:

/plugin marketplace add ComposioHQ/composio-plugin-cc
/plugin install composio@composio

See the Claude Code plugin guide for team installation, updates, and troubleshooting.

What the plugin uses

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.

Install only the CLI skill

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.

If you want the skill without the plugin, install it for your agent directly:

composio --install-skill composio-cli claude
composio --install-skill composio-cli codex

Choose another setup