About composio
composio is a skill for using Composio to connect agents and applications to external services. It covers direct CLI actions and SDK-based integration, including account linking and event listening.
Key features
- 01Search tools by task
- 02Link external app accounts
- 03Execute tools through CLI
- 04Listen for trigger events
- 05Initialize SDK projects
Use cases
- 01Send emails or post messages through an app
- 02Create issues in an external service
- 03Build agents that use external tools
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ composio-community/ skills --skill composioAfter installing, type/composioin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
AGENTS.mdrules/_template.mdapp-auth-configs.mdapp-auth-popup-ui.mdapp-connected-accounts.mdapp-custom-tools.mdapp-execute-tools.mdapp-fetch-tools.mdapp-modifiers.mdapp-tool-versions.mdapp-toolkits.mdapp-user-context.mdbuilding-with-composio.mdcomposio-cli.mdsetup-api-keys.mdtr-auth-auto.mdtr-auth-connections.mdtr-auth-manual.mdtr-building-chat-ui.mdtr-framework-ai-sdk.mdtr-framework-integration.mdtr-framework-mastra.mdtr-mcp-vs-native.mdtr-session-basic.mdtr-session-config.mdtr-session-lifecycle.mdtr-toolkit-query.mdtr-userid-best-practices.mdtriggers-create.mdtriggers-manage.mdDetails
From the project READMEWhen to Apply
- User wants to access or interact with external apps (Gmail, Slack, GitHub, Notion, etc.)
- User wants to automate a task using an external service (send email, create issue, post message)
- Building an AI agent or app that integrates with external tools
- Multi-user apps that need per-user connections to external services
Setup
Check if the CLI is installed; if not, install it:
curl -fsSL https://composio.dev/install | bash
After installation, restart your terminal or source your shell config, then authenticate:
composio login # OAuth; interactive org/project picker (use -y to skip)
composio whoami # verify org_id, project_id, user_id
For agents without direct browser access: composio login --no-wait | jq to get URL/key, share URL with user, then composio login --key <cli_key> --no-wait once they complete login.
1. Use Apps via Composio CLI
Use this when: The user wants to take action on an external app directly — no code writing needed. The agent uses the CLI to search, connect, and execute tools on behalf of the user.
Key commands (new top-level aliases):
composio search "<query>"— find tools by use casecomposio execute "<TOOL_SLUG>" -d '{...<input params>}'— execute a toolcomposio link [toolkit]— connect a user account to an app (agents: always use--no-waitfor non-interactive mode)composio listen— listen for real-time trigger events
Typical workflow: search → link (if needed) → execute
Full reference: Composio CLI Guide
2. Building Apps and Agents with Composio
Use this when: Writing code — an AI agent, app, or backend service that integrates with external tools via the Composio SDK.
Run this first inside the project directory to set up the API key:
composio init
Full reference: Building with Composio