What Is Composio? Connecting Apps to Claude Code and Codex, Setup, Free Plan and Data
You connect app accounts such as Gmail, Slack, GitHub, Notion and Linear to Composio; your AI assistant then takes actions in these apps, while Composio handles account connection (OAuth) and permissions. It's used as a command-line tool in the terminal, as a plugin for Claude Code and Codex, and as a hosted URL for MCP clients. The free Hobby plan doesn't require a card; it includes 100,000 tool calls per month, and for OAuth apps managed by Composio itself that allowance drops to 20,000. Actions on the accounts you connect pass through Composio's servers, and call logs are kept for up to one year.
- What it does
- Has your assistant take actions in apps like Gmail, Slack and GitHub
- Type
- Plugin + command-line tool + MCP URL
- Where
- Claude Code, Codex, Claude Desktop, ChatGPT, Cursor
- Account
- Requires a Composio account
- Windows
- Only inside WSL
- Data
- Calls pass through Composio's servers
- Cost
- Hobby $0; Pro $29/month
What Is Composio Used For?
To let an assistant use your Gmail or Slack, you'd have to set up authorization separately for each app. Composio takes this on: you connect your account once, and the assistant does things like "send a message on Slack," "open an issue in Linear" or "add an event to the calendar" on your behalf. The official pages give different numbers for how many apps it supports, such as 1,000+, 1,500+ and 1,600+.
Who it's for: developers and advanced users who work with Claude Code or Codex and want the assistant to take actions in outside apps too. Note: these actions make real changes in your account.
How Do You Install Composio?
› curl -fsSL https://composio.dev/install | sh› composio login!This command runs a script downloaded from the internet directly. Read it at https://composio.dev/install before running it. The script writes the PATH setting to your shell files and installs the plugin for any Claude Code and Codex it detects without asking; if you don't want that, put COMPOSIO_INSTALL_SHELL=none COMPOSIO_INSTALL_PLUGINS=0 in front of the command.
On Windows it only works inside WSL. The install script needs curl and unzip; it won't install if the SHA-256 doesn't match.
› /plugin marketplace add ComposioHQ/composio-plugin-cc› /plugin install composio@composioThen restart Claude Code or type /reload-plugins. On the first request, the plugin offers to install the CLI and sign you in. To connect an app in advance, type /composio-connect linear.
› composio login› composio setup --target codex- Claude: + › Connectors › Add custom connector; name it Composio, with the URL
https://connect.composio.dev/mcp. Sign in to Composio in the window that opens. - ChatGPT: Developer mode must be on (Plus, Pro, Business, Enterprise, Edu); enter the same URL when adding a new plugin on the Plugins page.
- Some clients require an
x-consumer-api-keyheader; you get the key from the Composio dashboard, and don't paste it into the chat.
How Do You Use Composio?
If the plugin is installed, you write a normal request to the assistant; if needed, the assistant installs the CLI, has you sign in and gives you an authorization link for the app (the link is valid for 10 minutes).
| Command | What it does |
|---|---|
| composio search | Searches app tools |
| composio link <app> | Connects an app account |
| composio execute | Runs a tool |
| composio run | Runs a script locally |
| composio upgrade | Updates the CLI |
No separate approval step for write actions is documented on the Composio side. Saying "show it to me before sending" and keeping Claude Code's permission prompts on is a good precaution.
Which Programs Does Composio Work With?
| Claude CodeYes | Plugin and CLI installation are in the documentation. |
|---|---|
| CodexYes | With composio setup --target codex. |
| Claude Desktop, ChatGPT, Cursor, VS Code and other MCP clientsYes | The documentation describes connecting with the MCP URL; some require a key header. |
| WindowsPartly | The install script only works inside WSL. |
"Not in the documentation" doesn't mean it doesn't work.
What Does Composio Access, and Where Does My Data Go?
It can read email, calendar, message, document and repository data in the apps you connect, and it performs actions such as sending messages, opening issues and adding events in the connected account. The documentation doesn't provide a separate list of deletions.
Tool calls pass through Composio's servers. The request and response data of every call is logged by default and kept for up to one year; your account keys are stored encrypted. Zero data retention is offered on paid plans for an extra fee.
The ~/.composio folder (credentials and settings), ~/.local/bin/composio and a PATH block in your shell file.
The Claude Code plugin includes two hooks. One adds context at the start of a session and updates the plugin on its own at most once a day.
No recorded advisories affecting the current CLI and SDK versions appear; there are records for the old Python packages (composio, composio-core). This doesn't mean it's safe.
!Before connecting customers' emails and documents, check your organization's data rules and your KVKK (Turkey's Personal Data Protection Law) obligations. This is not legal advice.
Is Composio Free?
Yes, there's a free Hobby plan; prices are in US dollars, and local-currency pricing and tax information aren't on the official page.
- 100,000 tool calls per month
- 50,000 triggers per month, 3 team members
- No card required
- Hard cap: usage stops when you hit the limit
- Only 20,000 calls free on Composio-managed apps
- Everything in Hobby
- $29 in monthly usage credits (doesn't roll over)
- Unlimited team members
- SSO, SCIM
- Highest limits
- SSO, SCIM, custom contract
- Support with an SLA
!On the plugin and Connect routes, authentication is done by default through Composio-managed apps; the pricing page says these aren't recommended for scaling. So keep in mind that your free allowance may in practice be 20,000 calls.
Source: Composio pricing page (as of October 14, 2026). The new prices apply to sign-ups on or after August 15, 2026; existing customers stay on the old plan until December 31, 2026. The repository license is MIT. This is not legal advice.
Official pricing page last checked on .
Common Problems and Fixes
| What's happening | What to do |
|---|---|
The composio command isn't found after installation | Open a new terminal or use the absolute path (~/.local/bin/composio). |
| The install script says "Windows is not supported" | Run the installation and the commands inside WSL. |
| Composio tools don't appear in Claude Desktop | In Connectors, look for the CUSTOM badge on Composio; ⋮ › Clear cache; if that doesn't work, Disconnect, Remove and add it again. |
| The authorization link didn't open or expired | Links are valid for 10 minutes; ask the assistant to retry the action and open the new link right away. |
| An app action gives a permission error | The connection may have expired (EXPIRED); remove the connection and reconnect. |
How Do You Uninstall Composio?
- Disconnect the app: Tell the assistant "Remove the Gmail connection in Composio"; also remove Composio's access in the app's own "connected apps" settings.
- Claude Desktop connector: ⋮ › Disconnect › Remove.
- CLI: Run the commands in the "Uninstall" section of the CLI documentation and delete the "# Composio CLI" block from your shell files. To delete your credentials too, delete the ~/.composio folder (this can't be undone).
Frequently asked questions
What is Composio, and what is it used for?
An intermediary service that lets your AI assistant take actions in apps like Gmail, Slack, GitHub and Linear. It handles connecting app accounts and permissions; it's used as a command-line tool, a Claude Code and Codex plugin, and an MCP URL.
How do I use Composio MCP?
You add the https://connect.composio.dev/mcp URL as a custom connector in a client that supports MCP and sign in with your Composio account. Some clients require a key header obtained from the Composio dashboard.
How do I install Composio in Claude Code?
In Claude Code, type /plugin marketplace add ComposioHQ/composio-plugin-cc and /plugin install composio@composio, then restart. For the CLI on macOS and Linux, there's the command curl -fsSL https://composio.dev/install | sh; read the script before running it.
Is Composio free?
Yes, the Hobby plan is free: 100,000 tool calls per month, no card required. For OAuth apps managed by Composio itself, the free allowance drops to 20,000 calls. Pro is $29 a month.
Does Composio store my data?
Tool calls pass through Composio's servers; the request and response data of every call is kept in the logs by default for up to one year. Zero data retention is offered on paid plans for an extra fee.
Does Composio work on Windows?
The install script only works inside WSL; on Windows you need to install it in a WSL distribution.
Related guides
Sources
- Composio CLI documentation
- Composio: Claude Code plugin
- Composio Connect (MCP URL)
- Composio pricing
- Composio: data retention
- Composio GitHub repository
- Claude Code plugin repository
Not clear in the official sources: Whether there's a separate approval step for write actions (not documented) · whether the same Hobby plan applies to "For You" personal use · behavior after 20,000 calls on Hobby (contradictory in two places) · the number of apps (1,000+, 1,500+, 1,600+) · Turkish and restrictions for Turkey. Each one is covered in its section, along with what you can do.