Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Composio is a Python and TypeScript SDK that gives AI agents access to over 1,000 pre-built tool integrations, covering services like GitHub, Slack, HackerNews, and many others, along with built-in authentication management, context handling, and a sandboxed workbench for testing agent behavior. The SDK connects to Claude through a dedicated Anthropic provider package available in both languages, meaning Claude-based agents can call any of those tools using standard function-calling patterns without developers needing to write their own API wrappers or OAuth flows. It also supports the MCP protocol via a remote MCP server, making it compatible with Claude Desktop and Claude Code environments. Provider packages exist for LangChain, LangGraph, CrewAI, AutoGen, Vercel AI SDK, and others, so teams already using those frameworks can adopt Composio without restructuring their agent code. The primary audience is developers building production AI agents who want managed third-party integrations and per-user authentication rather than hand-rolling each external service connection.
SDK and hosted toolkit layer giving agents 1000+ authenticated tools, tool search and a sandboxed execution workbench.
- ✓Open-source license (MIT)
- ✓Actively maintained (<30d)
- ✓Healthy fork ratio
- ✓Clear description
- ✓Topics declared
- ✓Mature repo (>1y old)
git clone https://github.com/ComposioHQ/composio && cp composio/*.md ~/.claude/agents/21 items in this repository
Validate a Composio CLI beta release and promote it to a stable release by dispatching the CLI binary workflow with an existing beta tag.
Write end-to-end tests for CLI commands using the Docker-based test framework in ts/e2e-tests/cli/.
CLI design guidelines — arguments, flags, subcommands, help, output, errors, interactivity, config precedence. Apply when designing new commands or reviewing CLI UX.
Implement new CLI commands in ts/packages/cli/ using Effect.ts patterns, service wiring, and @effect/cli declarations.
Release the CLI — diff features since last release, run /full-cli-test on them, and create a changeset PR with patch bump and test results.
Trigger a CI binary build via workflow dispatch, monitor it, download the artifact, and test the CLI binary locally.
Subagents overview
<div align="center">
<img src="https://raw.githubusercontent.com/ComposioHQ/composio/next/public/cover.png" alt="Composio Logo" width="auto" height="auto" style="margin-bottom: 20px;"/>
# Composio SDK
Skills that evolve for your Agents
[🌐 Website](https://composio.dev) • [📚 Documentation](https://docs.composio.dev)
[](https://github.com/ComposioHQ/composio/stargazers)
[](https://pypi.org/project/composio/)
[](https://www.npmjs.com/package/@composio/core)
[](https://discord.gg/composio)
[](https://hvtracker.net/agents/composio/)
</div>
This repository contains the official Software Development Kits (SDKs) for Composio, providing seamless integration capabilities for Python and Typescript Agentic Frameworks and Libraries.
## Getting Started
### TypeScript SDK Installation
```bash
# Using npm
npm install @composio/core
# Using yarn
yarn add @composio/core
# Using pnpm
pnpm add @composio/core
```
#### Quick start:
```typescript
import { Composio } from '@composio/core';
// Initialize the SDK
const composio = new Composio({
// apiKey: 'your-api-key',
});
```
#### Simple Agent with OpenAI Agents
```bash
npm install @composio/openai-agents @openai/agents
```
```typescript
import { Composio } from '@composio/core';
import { OpenAIAgentsProvider } from '@composio/openai-agents';
import { Agent, run } from '@openai/agents';
const composio = new Composio({
provider: new OpenAIAgentsProvider(),
});
const userId = 'user@acme.org';
const tools = await composio.tools.get(userId, {
toolkits: ['HACKERNEWS'],
});
const agent = new Agent({
name: 'Hackernews assistant',
tools: tools,
});
const result = await run(agent, 'What is the latest hackernews post about?');
console.log(JSON.stringify(result.finalOutput, null, 2));
// will return the response from the agent with data from HACKERNEWS API.
```
### Python SDK Installation
```bash
# Using pip
pip install composio
# Using poetry
poetry add composio
```
#### Quick start:
```python
from composio import Composio
composio = Composio(
# api_key="your-api-key",
)
```
#### Simple Agent with OpenAI Agents
```bash
pip install composio_openai_agents openai-agents
```
```python
import asyncio
from agents import Agent, Runner
from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider
# Initialize Composio client with OpenAI Agents Provider
composio = Composio(provider=OpenAIAgentsProvider())
user_id = "user@acme.org"
tools = composio.tools.get(user_id=user_id, toolkits=["HACKERNEWS"])
# Create an agent with the tools
agent = Agent(
name="Hackernews Agent",
instructions="You are a helpful assistant.",
tools=tools,
)
# Run the agent
async def main():
result = await Runner.run(
starting_agent=agent,
input="What's the latest Hackernews post about?",
)
print(result.final_output)
asyncio.run(main())
# will return the response from the agent with data from HACKERNEWS API.
```
For more detailed usage instructions and examples, please refer to each SDK's specific documentation.
### Open API Specification
To update the OpenAPI specifications used for generating SDK documentation:
```bash
# Pull the latest API specifications from the backend
pnpm api:pull
```
This command pulls the OpenAPI specification from `https://backend.composio.dev/api/v3/openapi.json` and updates the local API documentation files.
This is pulled automatically with build step.
## Available SDKs
### TypeScript SDK (/ts)
The TypeScript SDK provides a modern, type-safe way to interact with Composio's services. It's designed for both Node.js and browser environments, offering full TypeScript support with comprehensive type definitions.
For detailed information about the TypeScript SDK, please refer to the [TypeScript SDK Documentation](/ts/README.md).
### Python SDK (/python)
The Python SDK offers a Pythonic interface to Composio's services, making it easy to integrate Composio into your Python applications. It supports Python 3.10+ and follows modern Python development practices.
For detailed information about the Python SDK, please refer to the [Python SDK Documentation](/python/README.md).
## Provider Support
The following table shows which AI frameworks and platforms are supported in each SDK:
| Provider | TypeScript | Python |
|----------|:----------:|:------:|
| OpenAI | ✅ | ✅ |
| OpenAI Agents | ✅ | ✅ |
| Anthropic | ✅ | ✅ |
| LangChain | ✅ | ✅ |
| LangGraph | ✅* | ✅ |
| LlamaIndex | ✅ | ✅ |
| Vercel AI SDK | ✅ | ❌ |
| Google Gemini | ✅ | ✅ |
| Google ADK | ❌ | ✅ |
| Mastra | ✅ | ❌ |
| Cloudflare Workers AI | ✅ | ❌ |
| CrewAI | ❌ | ✅ |
| AutoGen | ❌ | ✅ |
\* *LangGraph in TypeScript is supported via the `@composio/langchain` package.*
> **Don't see your provider?** Learn how to [build a custom provider](https://docs.composio.dev/sdk/typescript/custom-providers) to integrate with any AI framework.
## Packages
### Core Packages
| Package | Version |
|---------|---------|
| **TypeScript** | |
| [@composio/core](https://www.npmjs.com/package/@composio/core) |  |
| **Python** | |
| [composio](https://pypi.org/project/composio/) |  |
### Provider Packages
| Package | Version |
|---------|---------|
| **TypeScript** | |
| [@composio/openai](https://www.npmjs.com/package/@composio/openai) |  |
| [@composio/openai-agents](https://www.npmjs.com/package/@composio/openai-agents) |  |
| [@composio/anthropic](https://www.npmjs.com/package/@composio/anthropic) |  |
| [@composio/langchain](https://www.npmjs.com/package/@composio/langchain) |  |
| [@composio/llamaindex](https://www.npmjs.com/package/@composio/llamaindex) |  |
| [@composio/vercel](https://www.npmjs.com/package/@composio/vercel) |  |
| [@composio/google](https://www.npmjs.com/package/@composio/google) |  |
| [@composio/mastra](https://www.npmjs.com/package/@composio/mastra) |  |
| [@composio/cloudflare](https://www.npmjs.com/package/@composio/cloudflare) |  |
| **Python** | |
| [composio-openai](https://pypi.org/project/composio-openai/) |  |
| [composio-openai-agents](https://pypi.org/project/composio-openai-agents/) |  |
| [composio-anthropic](https://pypi.org/project/composio-anthropic/) |  |
| [composio-langchain](https://pypi.org/project/composio-langchain/) |  |
| [composio-langgraph](https://pypi.org/project/composio-langgraph/) |  |
| [composio-llamaindex](https://pypi.org/project/composio-llamaindex/) |  |
| [composio-crewai](https://pypi.org/project/composio-crewai/) |  |
| [composio-autogen](https://pypi.org/project/composio-autogen/) |  |
| [composio-gemini](https://pypi.org/project/composio-gemini/) |  |
| [composio-google](https://pypi.org/project/composio-google/) |  |
| [composio-google-adk](https://pypi.org/project/composio-google-adk/) |  |
### Utility Packages
| Package | Version |
|---------|---------|
| [@composio/json-schema-to-zod](https://www.npmjs.com/package/@composio/json-schema-to-zod) |  |
| [@composio/ts-builders](https://www.npmjs.com/package/@composio/ts-builders) |  |
_if you are looking for the older sdk, you can find them [here](https://github.com/ComposioHQ/composio/tree/master)_
## Rube
[Rube](https://rube.app) is a Model Context Protocol (MCP) server built with Composio. It connects your AI tools to 500+ apps like Gmail, Slack, GitHub, and Notion. Simply install it in your AI client, authenticate once with your apps, and start asking your AI to perform real actions like "Send an email" or "Create a task."
It integrates with major AI clients like Cursor, Claude Desktop, VS Code, Claude Code and any custom MCP‑compatible client. You can switch between these clients and your integrations follow you.
## Contributing
We welcome contributions to both SDKs! Please read our [contribution guidelines](https://github.com/ComposioHQ/composio/blob/next/CONTRIBUTING.md) before submitting pull requests.
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Support
If you encounter any issues or have questions about the SDKs:
- Open an issue in this repository
- Contact our [What people ask about composio
What is ComposioHQ/composio?
+
ComposioHQ/composio is subagents for the Claude AI ecosystem. Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action. It has 28.7k GitHub stars and was last updated today.
How do I install composio?
+
You can install composio by cloning the repository (https://github.com/ComposioHQ/composio) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.
Is ComposioHQ/composio safe to use?
+
Our security agent has analyzed ComposioHQ/composio and assigned a Trust Score of 90/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.
Who maintains ComposioHQ/composio?
+
ComposioHQ/composio is maintained by ComposioHQ. The last recorded GitHub activity is from today, with 129 open issues.
Are there alternatives to composio?
+
Yes. On ClaudeWave you can browse similar subagents at /categories/agents, sorted by popularity or recent activity.
Deploy composio to your cloud
Ship this repo to production in minutes. Each platform spins up its own environment with editable env vars.
Maintain this repo? Add a badge to your README
Drop the badge into your GitHub README to show it's tracked on ClaudeWave. Each badge links back to this page and reflects the live Trust Score.
[](https://claudewave.com/repo/composiohq-composio)<a href="https://claudewave.com/repo/composiohq-composio"><img src="https://claudewave.com/api/badge/composiohq-composio" alt="Featured on ClaudeWave: ComposioHQ/composio" width="320" height="64" /></a>More Subagents
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
The agent that grows with you
Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Production-ready platform for agentic workflow development.
The agent engineering platform.
🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.