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 | name: composio |
| 3 | description: Route and complete Composio work across Composio For You and Composio Platform. Use when the user mentions Composio; wants an agent to use apps such as Gmail, Slack, GitHub, Notion, Calendar, or Linear; needs first-time setup, an SDK or MCP integration, CLI operation, tool approvals, Firewall hooks, a custom MCP server, migration guidance, current documentation, or help diagnosing a connection or tool call. |
| 4 | --- |
| 5 | |
| 6 | # Composio |
| 7 | |
| 8 | Use this skill as a router. Identify the product and the job, load only the relevant guidance, consult canonical documentation for volatile details, and then answer or do the work the user requested. |
| 9 | |
| 10 | ## 1. Choose the product |
| 11 | |
| 12 | Do not blend the products. They use different credentials and setup paths. |
| 13 | |
| 14 | | | Composio For You | Composio Platform | |
| 15 | |---|---|---| |
| 16 | | Use when | Someone wants their own agent to use their own apps | A developer is building a product whose users connect accounts | |
| 17 | | Primary surface | MCP or the Composio CLI | SDK sessions inside an application | |
| 18 | | Credential | `ck_...` consumer key when the client requires a header | `COMPOSIO_API_KEY` project key | |
| 19 | | Dashboard | `dashboard.composio.dev` → For You | `dashboard.composio.dev` → Platform | |
| 20 | |
| 21 | Ask one short question only when context does not establish the product: |
| 22 | |
| 23 | > Is this for your own agent and accounts, or for a product where your users connect their accounts? |
| 24 | |
| 25 | Treat a named personal AI client with no product code as For You. Treat an application codebase, SDK, user or tenant identity, backend, or product agent as Platform. |
| 26 | |
| 27 | ## 2. Choose the job |
| 28 | |
| 29 | Identify the requested outcome before taking action: |
| 30 | |
| 31 | - **Explain or discover:** answer a question, compare approaches, or find the current API. |
| 32 | - **Set up:** establish credentials, an MCP client, the CLI, or an SDK for the first time. |
| 33 | - **Build or change:** integrate Composio into an existing agent or application. |
| 34 | - **Operate:** find, connect, and run tools for a real task. |
| 35 | - **Debug or migrate:** diagnose a failure, update an older integration, or move from legacy direct execution or Tool Router. |
| 36 | |
| 37 | Do not turn an explanation, documentation lookup, or narrow bug fix into onboarding. |
| 38 | |
| 39 | ## 3. Load only the relevant guidance |
| 40 | |
| 41 | - For You: read [Composio For You](references/for-you.md). |
| 42 | - Platform: read [Composio Platform](references/platform.md). It also covers Approvals, Firewall, and Custom MCP. |
| 43 | - Provider, connection, or execution failure, including a call paused for approval or blocked by Firewall: also read [Errors and provider gotchas](references/errors.md). |
| 44 | |
| 45 | ## Complete the selected job |
| 46 | |
| 47 | - For a question, fetch current documentation when needed and give the concrete answer. Do not mutate a project or force a tool call. |
| 48 | - For setup or integration, inspect the existing environment, preserve its architecture and identity model, make the smallest useful change, and verify it with one safe real tool call when credentials and user authorization are available. |
| 49 | - For an operational request, connect only the apps the task needs and execute the requested workflow. |
| 50 | - For debugging, get the Composio log or request ID, identify the failing boundary, fix that boundary, and retry when the user authorized execution. |
| 51 | |
| 52 | ## Stable rules |
| 53 | |
| 54 | 1. Establish the product before choosing credentials, URLs, SDKs, or commands. |
| 55 | 2. Treat dashboard onboarding as a context, not the skill's identity. When the developer arrives with an existing `COMPOSIO_API_KEY` from Getting Started, use it and never create, rotate, replace, print, or request it in chat. Do not run `composio dev init` in that path. |
| 56 | 3. For a general first-time Platform setup with no dashboard credential handoff, follow the current setup path in the Platform guide. |
| 57 | 4. Reuse an existing Composio credential first: a `COMPOSIO_API_KEY`, a saved CLI login, or a saved agent identity. Only when the task needs Composio, no credential exists, and no human is available to log in, follow [Authenticate an unattended agent](https://docs.composio.dev/docs/agent-setup/unattended-authentication) and run `composio login --agent`. A mention of Composio is not a reason to create an account, and an agent account does not authorize anyone's apps. |
| 58 | 5. Never invent toolkit or tool slugs. Discover them at runtime or with the CLI. |
| 59 | 6. Do not build a provider OAuth flow. Composio returns a Connect Link when authentication is needed. |
| 60 | 7. Use sessions for new Platform integrations. For auth-only use with tools the developer already owns, follow [managed authentication for your own tools](https://docs.composio.dev/docs/authentication/managed-auth-for-custom-tools.md): Connect Link + Proxy Execute, without fetching catalog tools. Preserve the application's existing user identity and agent architecture. |
| 61 | 8. Keep credentials out of source control, URLs, logs, chat, and command output. |
| 62 | 9. Get the log or request ID before diagnosing a failed tool call. |
| 63 | 10. Prefer the smallest configuration that completes the current job. Keep toolkit filters, tag policies, approvals, Firewall hooks, Custom MCP toolkits, sandbox controls, custom auth, provider-specific hardening, and other advanced options out of the first path unless the request or existing code requires them. When the request does ask for one, such as "ask before sending" or "block prompt injection", use the documented feature instead of building a substitute in prompts or application code. |
| 64 | 11. Do not invent repository facts. Never claim that a file, framework, environment loader, identity field, agent path, or dependency exists until it was provided or inspected. If codebase context is unavailable, state the unknown and ask for access or one necessary detail. |
| 65 | 12. In SDK or API examples, use exact identifiers and call shapes from a current public page or schema. Copy the documented shape for the requested language instead of translating names between TypeScript and Python; if a required detail is not documented, explain the behavior without inventing code. |
| 66 | 13. A product may ship both a Composio Built toolkit (`notion`) and a Provider MCP toolkit (`notion_mcp`) grouped as one App in the catalog. They are separate toolkits with separate connections. Use the slug the user or the code names; when the slug is unspecified, compare auth schemes, connected state, tool lists, and triggers, prefer the toolkit the user can authenticate, and state which one you chose. Never assume the `_mcp` toolkit is newer, larger, or shares a connection with its sibling. |
| 67 | |
| 68 | ## Canonical information |
| 69 | |
| 70 | Use bundled references for stable decisions. A user-facing source list contains only public `https://docs.composio.dev/...` pages actually consulted; bundled reference names, local paths, and `file://` URLs are omitted. For versions, provider adapters, client-specific setup, toolkit behavior, or APIs that may have changed, use the current canonical documentation and current CLI or tool schemas as the primary sources before answering or editing code: |
| 71 | |
| 72 | When sources disagree, prefer the current API reference and live endpoint behavior over any page marked Legacy, and name the REST API version explicitly. |
| 73 | |
| 74 | ```text |
| 75 | https://docs.composio.dev/llms.txt |
| 76 | https://docs.composio.dev/docs/<page>.md |
| 77 | https://docs.composio.dev/toolkits/<toolkit>.md |
| 78 | ``` |
| 79 | |
| 80 | If those primary sources do not answer a Composio product or troubleshooting question, query the public unified knowledge search at `https://docs.composio.dev/api/knowledge-search?q=<question>`. |
| 81 | |
| 82 | Results may be canonical docs, KB, toolkit, example, or reference pages. Use the returned evidence to answer the question; public records do not establish the live state of a user's account, project, connection, or tool call. |
| 83 | |
| 84 | When knowledge search supplies evidence, cite the result's returned `canonicalUrl`, not the search API URL. If `canonicalUrl` is relative, prefix it with `https://docs.composio.dev` before citing it. |
| 85 | |
| 86 | Only treat a result as evidence when its excerpt or page directly addresses the question. If no public source directly documents an exact error or symptom, say so instead of diagnosing from adjacent results; request the log or request ID, or the necessary live evidence. |
| 87 | |
| 88 | Use the documentation to complete the task. Do not merely hand the user a link unless they asked for one. |