Repolode
ComposioHQ

ComposioHQ/composio

TypeScript and Python SDK giving AI agents 1000+ pre-authenticated app toolkits, per-user sessions, and a sandbox to take actions.

Open-source alternative to:Zapier

Stars
30,646
Forks
4,875
Open issues
138
Last commit
8 hours ago

What is it?

Composio is an SDK for connecting AI agents to external apps. It provides more than 1000 toolkits that come with authentication already handled, so an agent can read email, update tickets or call other services without the developer building each integration by hand.

The SDK scopes work into sessions tied to individual users. A session exposes meta tools that let the agent discover, authenticate and execute app tools at runtime, which avoids loading hundreds of tool definitions into the model context. Sessions can also be exposed as a hosted MCP endpoint for clients such as Claude or Cursor.

The repository ships a TypeScript SDK (@composio/core), a Python SDK, a command-line tool for searching and running tools from a shell, and provider adapters for frameworks including OpenAI Agents, Claude Agent SDK, Vercel AI SDK, LangChain, LlamaIndex and CrewAI.

Key features

  • 01Provides 1000+ toolkits with authentication handled for each user session.
  • 02Offers meta tools that discover, authenticate and execute app tools at runtime.
  • 03Exposes sessions as a hosted MCP endpoint for MCP-compatible clients.
  • 04Ships TypeScript and Python SDKs with matching APIs.
  • 05Includes a CLI for searching, executing and linking tools from a shell.
  • 06Supports many agent frameworks through provider adapters.

Use cases

  • Building an personal assistant agent that acts on a user's email, calendar or documents.
  • Giving a coding agent such as Claude Code access to external app actions through the CLI or MCP.
  • Adding multi-app integrations to an existing LangChain, LlamaIndex or OpenAI Agents application without writing each connector.
  • Keeping per-user connected accounts separate in a multi-tenant AI product.

Quick start

  1. 1

    Install the TypeScript SDK and the OpenAI Agents provider

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

    Get a COMPOSIO_API_KEY from the Composio dashboard

  3. 3

    Create a session for a user, pass its tools to an agent, and run it

Things to know

  • Requires a Composio API key from the dashboard before the SDK can be used.
  • The TypeScript SDK is tested against Node 22+ only.

Topics

FAQ

What is composio?
TypeScript and Python SDK giving AI agents 1000+ pre-authenticated app toolkits, per-user sessions, and a sandbox to take actions. Composio is an SDK for connecting AI agents to external apps. It provides more than 1000 toolkits that come with authentication already handled, so an agent can read email, update tickets or call other services without the developer building each integration by hand.
Is composio free to use? What license does it have?
composio is open source under the MIT license. Check the license terms before using it in commercial products.
Is composio still maintained?
Actively maintained. The last commit to composio was on Oct 20, 2026.
What can I use composio for?
Building an personal assistant agent that acts on a user's email, calendar or documents. Giving a coding agent such as Claude Code access to external app actions through the CLI or MCP. Adding multi-app integrations to an existing LangChain, LlamaIndex or OpenAI Agents application without writing each connector. Keeping per-user connected accounts separate in a multi-tenant AI product.
How do I install composio?
Install the TypeScript SDK and the OpenAI Agents provider: npm install @composio/core @composio/openai-agents @openai/agents Get a COMPOSIO_API_KEY from the Composio dashboard Create a session for a user, pass its tools to an agent, and run it
Where can I get composio?
The source code and installation instructions are on GitHub: https://github.com/ComposioHQ/composio

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects