Developers building AI agents in TypeScript or Python who are comfortable with an agent framework and need a Composio API key from the dashboard first.

What can you build with composio?

Build an assistant that summarizes a user's emails from today. Give a multi-user agent app separate, authenticated access to each user's connected accounts. Connect Claude, Cursor or another MCP client to many apps through one hosted MCP endpoint. Let a coding agent such as Claude Code search and run tools from your terminal with the composio CLI. Write a custom provider to add Composio tools to an agent framework that has no adapter yet.

How do I get started with composio?

Get a COMPOSIO_API_KEY from the Composio dashboard and install the SDK plus a provider for your agent framework. Then create a session for a user, pass session tools to your agent, and run it. The README example uses the OpenAI Agents provider. Commands from the README: npm install @composio/core @composio/openai-agents @openai/agents; pip install composio composio-openai-agents openai-agents; curl -fsSL https://composio.dev/install | sh.

ComposioHQ /

composio

SDK and CLI that connect AI agents to 1000+ apps with per-user auth

30.7k stars
298 stars since 3 Oct
TypeScript
Updated today
Some experience
AI agents

Open on GitHub (opens in a new tab) Website (opens in a new tab)

Agents are only useful if they can do things in other apps: read email, file tickets, post messages. Each app has its own API and its own login rules. Composio packages those integrations as toolkits and handles authentication for you.

You create a session for each of your users, then hand that session's tools to your agent. By default the session gives the agent a few meta tools that find, authenticate and run app tools while it works. This means you don't load hundreds of tool definitions into the model's context.

Provider adapters convert the tools into the format your agent framework expects, such as OpenAI Agents, Claude Agent SDK, Vercel AI SDK, LangChain or CrewAI. If your framework isn't listed, you can write a custom provider or connect over MCP, since every session can expose a hosted MCP endpoint.

What it does

1000+ pre-authenticated toolkits
Ready-made tools for many apps, with authentication handled so your agent can act on a user's behalf.
Per-user sessions
Each session is scoped to one of your users. You can store the session ID and reuse it across turns.
Runtime tool discovery
Meta tools search for, authenticate and execute app tools on demand, keeping the context small.
Framework adapters
Providers for OpenAI, Anthropic, Claude Agent SDK, Vercel AI SDK, Google, LangChain, LlamaIndex, Mastra, CrewAI, AutoGen and others, in TypeScript and Python.
CLI and MCP
The composio CLI can search, execute and script tools from your shell, and sessions can expose a hosted MCP URL for clients like Claude or Cursor.

What you could build

Build an assistant that summarizes a user's emails from today.
Give a multi-user agent app separate, authenticated access to each user's connected accounts.
Connect Claude, Cursor or another MCP client to many apps through one hosted MCP endpoint.
Let a coding agent such as Claude Code search and run tools from your terminal with the composio CLI.
Write a custom provider to add Composio tools to an agent framework that has no adapter yet.

Get started

Get a COMPOSIO_API_KEY from the Composio dashboard and install the SDK plus a provider for your agent framework. Then create a session for a user, pass session tools to your agent, and run it. The README example uses the OpenAI Agents provider.

npm install @composio/core @composio/openai-agents @openai/agents

pip install composio composio-openai-agents openai-agents

curl -fsSL https://composio.dev/install | sh

Commands are copied from the project's README. Read it on GitHub for the full setup.