Open-source SDK for building and running AI agents in Python and TypeScript, with tools, MCP, memory, and model portability.
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
Install the TypeScript SDK and the OpenAI Agents provider
npm install @composio/core @composio/openai-agents @openai/agents - 2
Get a COMPOSIO_API_KEY from the Composio dashboard
- 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
AutoGPT is an open-source platform for building, running, and scheduling AI agents that carry out multi-step workflows from plain-English descriptions or a visual builder.
A visual platform for building, testing and deploying AI agents and workflows, with built-in API and MCP server exposure.
Agent memory system that stores, recalls and reflects on memories so AI agents learn over time instead of only replaying chat history.
The official TypeScript SDK for building Model Context Protocol servers and clients that give LLM applications standardized context.
TypeScript framework for building AI agents with memory, tools, MCP, RAG, voice and workflows, plus the VoltOps console for observability.