mcpField
C
composio

composio

github.com/composio-communityAgent workflows1847.0k installsUpdated 32w ago
Repository

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

  1. 01Search tools by task
  2. 02Link external app accounts
  3. 03Execute tools through CLI
  4. 04Listen for trigger events
  5. 05Initialize SDK projects

Use cases

  1. 01Send emails or post messages through an app
  2. 02Create issues in an external service
  3. 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 composio

After installing, type/composioin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

AGENTS.md
rules/
_template.md
app-auth-configs.md
app-auth-popup-ui.md
app-connected-accounts.md
app-custom-tools.md
app-execute-tools.md
app-fetch-tools.md
app-modifiers.md
app-tool-versions.md
app-toolkits.md
app-user-context.md
building-with-composio.md
composio-cli.md
setup-api-keys.md
tr-auth-auto.md
tr-auth-connections.md
tr-auth-manual.md
tr-building-chat-ui.md
tr-framework-ai-sdk.md
tr-framework-integration.md
tr-framework-mastra.md
tr-mcp-vs-native.md
tr-session-basic.md
tr-session-config.md
tr-session-lifecycle.md
tr-toolkit-query.md
tr-userid-best-practices.md
triggers-create.md
triggers-manage.md

Details

From the project README

When 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 case
  • composio execute "<TOOL_SLUG>" -d '{...<input params>}' — execute a tool
  • composio link [toolkit] — connect a user account to an app (agents: always use --no-wait for 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

Comments

Markdown supported