ComposioHQ /composio
Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
★ 31,085⑂ 4,952👁 74⑃ 4,363● 861▤ 1,228
+14
日增长
+184
周增长
31,085
stars
4,952
forks
74
watchers
4,363
prs
861
issues
1,228
releases
README
composio.dev •
Documentation •
Quickstart •
Changelog
Composio
Composio gives your AI agents 1000+ pre-authenticated toolkits, per-user sessions, authentication, triggers, and a sandbox, so you can ship agents that turn intent into action.
This is the Composio SDK monorepo. It contains:
- @composio/core: TypeScript SDK
- composio: Python SDK
- composio CLI: search, execute, and script tools from your shell
- Provider adapters for OpenAI Agents, Claude Agent SDK, Vercel AI SDK, LangChain, and more
Quickstart
Create a session for a user, hand its tools to your agent, and let the agent take action across 1000+ apps. Grab a COMPOSIO_API_KEY from the dashboard first.
TypeScript
bash
npm install @composio/core @composio/openai-agents @openai/agents
@composio/core intentionally packages its TypeScript source and SDK docs so the installed package is inspectable to coding agents. If you want a smaller install with the same API, use @composio/slim.
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() });
// Each session is scoped to one of your users
const session = await composio.create("user_123");
const tools = await session.tools();
const agent = new Agent({
name: "Personal Assistant",
instructions: "You are a helpful assistant. Use Composio tools to take action.",
tools,
});
const result = await run(agent, "Summarize my emails from today");
console.log(result.finalOutput);
Python
bash
pip install composio composio-openai-agents openai-agents
python
from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider
from agents import Agent, Runner
composio = Composio(provider=OpenAIAgentsProvider())
Each session is scoped to one of your users
session = composio.create(user_id="user_123")
tools = session.tools()
agent = Agent(
name="Personal Assistant",
instructions="You are a helpful assistant. Use Composio tools to take action.",
tools=tools,
)
result = Runner.run_sync(starting_agent=agent, input="Summarize my emails from today")
print(result.final_output)
By default a session gets meta tools that discover, authenticate, and execute app tools at runtime, so you don't load hundreds of tool definitions into context. Store session.session_id and reuse it with composio.use() across turns. See what a session is and configuring sessions for restricting toolkits, auth configs, and connected accounts.
Prefer MCP? Every session also exposes a hosted MCP endpoint. Pass mcp: true to composio.create() and point Claude, Cursor, or any MCP client at session.mcp.url. See sessions via MCP.
CLI
The composio CLI runs Composio from your shell and gives coding agents like Claude Code a local tool surface.
bash
curl -fsSL https://composio.dev/install | sh
The installer puts composio on your PATH fTop issues
#4613[Feature]: x402 pay-per-call settlement on the tool-execution path6 comments · 2026-09-24#3175[Bug]: 29 toolkit logo URLs return 404/errors6 comments · 2026-04-10#5267[Feature]: OpenTelemetry spans for tool execution5 comments · 2026-11-07#4482Feature: Persistent agent memory — agents forget everything across sessions5 comments · 2026-09-14#4248[Feature]: Allow multiple SHARED connections per toolkit in multi-account Tool Router sessions4 comments · 2026-08-26#4013YOUTUBE_UPDATE_VIDEO silently destroys embeddable / publicStatsViewable when changing privacy_status4 comments · 2026-07-31#3777[Bug]: Tool-router session.search omits Google Ads tools that exist in catalog and are executable4 comments · 2026-07-09#3776[Bug]: Tool Router: session.search silently omits no-auth toolkits when the session also enables an auth-based toolkit4 comments · 2026-07-09
Discussions
#5337Toolkit request: Odds-API.io (sports odds API)0 comments · 2026-11-12#5265Toolkit request: ShapelessAI (shapelessai.com), social media publishing and content for agents0 comments · 2026-11-07#5263Run Firewall on the no-code MCP path for Codex, Grok Bot, and any MCP client0 comments · 2026-11-07#4961Preserving transport-error classification across Python local custom tool boundaries1 comments · 2026-10-19#4807Threads toolkit: a managed Meta Threads integration with the full API surface0 comments · 2026-10-11#4763Toolkit proposal: Evaboot (LinkedIn Sales Navigator leads + email finding)0 comments · 2026-10-06#4550Toolkit request: Outstand (outstand.so) — unified social media publishing API0 comments · 2026-09-21#4461Simplifying agent-to-agent discovery and messaging1 comments · 2026-09-12
Latest release
CLI @composio/[email protected] @composio/[email protected] 2026-11-13What's Changed chore(sdk): update composio-client to 2.1.32 by @sdkrelease[bot] in https://github.com/ComposioHQ/composio/pull/5315 Full Changelog: https://github.com/ComposioHQ/composio/compare/@composio/[email protected]...@composio/[email protected]