composio Skill for Claude Code: What It Does and How to Install It

Makes Claude work out which Composio product you need, then set it up, run it or fix it, without mixing the two products.

Installs: 8.4K; on skills.sh
Stars: 30.9K; on GitHub
Files: 3; besides SKILL.md
Updated: Nov 2026; last repo commit

This is the Composio team's own skill, from the vendor's own repo. Claude first decides between Composio For You (your own agent and your own apps, through MCP or the Composio CLI) and Composio Platform (a product where your users connect accounts, through the SDK). Then it loads the matching guide and does the job you asked for, such as explaining, setting up, building, operating or debugging.

It triggers when you mention Composio or ask an agent to use apps like Gmail, Slack, GitHub, Notion, Calendar or Linear. It bundles no scripts. It points Claude at Composio's docs on docs.composio.dev and, for setup, at the Composio CLI, which you install separately.

Good for

People who want their own AI client or terminal agent to use their Gmail, Slack, GitHub, Notion or Calendar accounts
Developers adding Composio sessions to an app where their users connect accounts
Anyone debugging a Composio connection or a failed tool call

Install composio

Claude Code

1
Download the skill folder from https://github.com/composiohq/composio/tree/HEAD/skills/composio.
2
Put it at ~/.claude/skills/composio/ so that SKILL.md sits directly inside.
3
Start a new session; the skill loads when its description matches the task.

The reference file says to install this skill explicitly from ComposioHQ/composio. It is a router and installs no Composio tools; the For You guide says raw MCP and the Composio CLI are separate surfaces. It may run the Composio CLI, so there is no Claude app upload tab.

Built from the package data we hold. Not yet tested by us.

What's in the skill

When it loads

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, migration guidance, current documentation, or help diagnosing a connection or tool call.

Sections in SKILL.md

1. Choose the product
2. Choose the job
3. Load only the relevant guidance
Complete the selected job
Stable rules
Canonical information

Key facts

Author: Composio (the vendor's own repo, ComposioHQ/composio)
License: MIT (LICENSE file, copyright Sampark Inc.)
Installs on skills.sh: 8,415 (Nov 2, 2026)
GitHub stars: 30,866 for the whole ComposioHQ/composio repo (Nov 2, 2026)
Last repo commit: Nov 1, 2026
What it includes: 4 files: SKILL.md and 3 reference files (for-you, platform, errors); no scripts
Needs: A Composio account. For You uses the MCP endpoint or the Composio CLI; Platform uses a project API key.

What it includes

Decides between Composio For You and Composio Platform, asking one question if unclear
A personal AI client with no product code means For You. An application codebase, SDK or user identity means Platform.
Read · Choose the product
Sorts your request: explain, set up, build, operate, or debug and migrate
It does not turn a question or a narrow bug fix into a full onboarding.
Choose the job
MCP endpoint, consumer key header, CLI steps and connection fixes for your own agent
Covers the MCP endpoint, the x-consumer-api-key header, the Composio CLI (login, search, link, execute) and what to check when tools do not appear.
Try: “Connect my Gmail to Claude through Composio”
Runs code · references/for-you.md
Project access, SDK install, per-user sessions and how to verify the setup
Reads your codebase, installs @composio/core or the composio Python package and adds a user-scoped session to the existing agent.
Try: “Add Composio sessions to my agent so each user can connect Slack”
Runs code · references/platform.md
Start from the log or request ID, then find which sign-in step failed
Shared debugging guide: tool not found, project 401, provider 401. It lists composio dev logs and composio connections list.
Runs code · references/errors.md
Fetches current docs.composio.dev pages before version-sensitive answers
SKILL.md names llms.txt, per-page .md files and a public knowledge-search endpoint as the primary sources.
Network · Docs lookup

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can run the CLI install script and dev init
The guides show curl -fsSL https://composio.dev/install | bash and composio dev init, which writes COMPOSIO_API_KEY and COMPOSIO_TEST_USER_ID to .env.local. Read the script and check .gitignore before you let Claude run them. github.com
Connected apps can be acted on, not just read
Once you authorise an app, composio execute and session tools can run its actions. Connect only the apps the task needs and review each action. github.com
It edits your code to add the SDK
The Platform guide installs @composio/core or the composio Python package and adds a user-scoped session to your agent. Review the diff. github.com
Its rules for keys
SKILL.md says never to print or request a dashboard project key in chat, and not to run composio dev init when you already have one. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	None. The Platform guide asks for a safe read-only tool call to verify setup, but that is not a switch.
Talks to	connect.composio.dev (MCP endpoint). docs.composio.dev (docs and knowledge search). composio.dev (CLI install script)
Sign-in and keys	For You uses a ck_ consumer key or browser sign-in. Platform reads COMPOSIO_API_KEY from the environment. SKILL.md says to keep credentials out of source control, URLs, logs, chat and command output.
Scopes	Runs Composio CLI commands (login, search, link, execute) when the task needs them Edits your project to add the Composio SDK and a session Writes .env.local when composio dev init is used Runs tools on the apps you authorise, such as Gmail or Slack

Questions

What does the composio skill do?

It makes Claude act as a router for Composio. It decides whether you are using Composio For You (your own agent and apps) or Composio Platform (an app whose users connect accounts), loads the matching guide, then explains, sets up, builds, operates or debugs.

Is it official?

Yes, it lives in the vendor's own repo, ComposioHQ/composio.

How do I install it?

Use the install box above. The reference file says to install the skill explicitly from ComposioHQ/composio. Our advice: the skill does not install the Composio CLI or any tools for you, so add those only when the task needs them.

Does it give Claude the Composio tools?

No. The reference file says a raw MCP connection gives an agent callable tools but installs no skill, and the skill is the router. You can have tools without the skill, or the reverse.

Does it need an API key?

It depends on the product. For You uses a ck_ consumer key only when the client needs a header, and Claude Desktop and ChatGPT use browser sign-in with no key. Platform uses a COMPOSIO_API_KEY project key. SKILL.md says to keep keys out of chat, logs, URLs and source control.

Is it safe?

It can run the Composio CLI, install an SDK in your project and, once you authorise an app, run tools against it. The Platform guide says to verify with one safe read-only call. Review any install command and check which apps you connect.

What is the difference between For You and Platform?

For You is for your own agent using your own accounts, through MCP or the CLI. Platform is for developers building an app whose users connect their accounts, using SDK sessions. They use different keys, which are not interchangeable.

Does it work in the Claude app, Codex or Cursor?

The skill files name no client list for the skill itself. The For You guide covers MCP setup for Claude Desktop, ChatGPT and header-based MCP clients. Check the current Composio docs before setting up a client.

Information

updated Nov 2, 2026

Repository: composiohq/composio
Folder: skills/composio

composiohq/composio skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

for-you.md · github.com
SKILL.md · github.com
platform.md · github.com
errors.md · github.com
LICENSE · github.com