composio_skill

Overview

This skill helps you build AI agents and traditional apps using Composio, exposing 200+ external tools via a Tool Router or direct execution. It supports session-based agent isolation, automatic authentication flows, MCP-compatible integration with AI frameworks, and direct CRUD-style tool execution for conventional apps. Use it to quickly connect Gmail, Slack, GitHub, and other services into chat agents or automated workflows.

How this skill works

Choose between Tool Router (for agents) and Direct Execution (for apps). Tool Router creates per-user MCP sessions with scoped toolkits, automatic auth handling, and an MCP URL you can plug into any AI framework. Direct Execution lets you fetch tools, run operations manually, manage connected accounts and auth configs, and build pre/post-execution hooks and custom tools.

When to use it

• Building chat-based or autonomous agents that must access external services securely
• Creating multi-user, multi-tenant applications with session isolation and scoped tool access
• Integrating Composio with AI frameworks (Vercel AI SDK, LangChain, OpenAI Agents, Claude) via MCP
• Implementing automation workflows, CRUD apps, or custom tooling with direct control over execution
• Building event-driven systems or webhooks using triggers for real-time reactions

Best practices

• Prefer Tool Router for agents to get automatic authentication, per-session isolation, and MCP compatibility
• Use Direct Execution when you need fine-grained control over tool calls, version pinning, and CRUD resource management
• Follow user ID best practices to ensure security and correct multi-tenant isolation
• Pin toolkit/tool versions in production to avoid breaking changes from upstream updates
• Implement connection state checks and UI flows so users can manage linked accounts and reauthorize as needed

Example use cases

• Create a Gmail + Calendar chat assistant that composes and schedules messages with per-user credentials
• Build an autonomous agent that monitors GitHub issues and files pull requests using Tool Router triggers
• Develop a multi-tenant admin dashboard to manage connected accounts, auth configs, and toolkit versions via Direct Execution
• Implement webhook-driven workflows that trigger tools on incoming events, with webhook verification and real-time subscriptions
• Add custom tools and modifiers to enrich or sanitize inputs before tool execution in production