composio README

The project's README from github.com/ComposioHQ/composio. As one markdown file: README.md.

Composio logo

composio.dev • Documentation • Quickstart • Changelog

GitHub stars npm PyPI Discord HVTrust

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:

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

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.

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

pip install composio composio-openai-agents openai-agents

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.

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

The installer puts composio on your PATH for future terminals. Open a new terminal, then run composio login. See INSTALL.md for shell setup overrides, including COMPOSIO_INSTALL_SHELL=none for install-only runs.

Use composio search to find tools, composio execute to run them, composio link to connect accounts, and composio run to script workflows in TypeScript. See the CLI docs.

Providers

A provider adapts Composio tools to your agent framework's native tool format:

Provider TypeScript Python
OpenAI @composio/openai composio-openai
OpenAI Agents @composio/openai-agents composio-openai-agents
Anthropic @composio/anthropic composio-anthropic
Claude Agent SDK @composio/claude-agent-sdk composio-claude-agent-sdk
Vercel AI SDK @composio/vercel —
Google GenAI @composio/google composio-gemini, composio-google
Google ADK — composio-google-adk
LangChain @composio/langchain composio-langchain
LangGraph via @composio/langchain composio-langgraph
LlamaIndex @composio/llamaindex composio-llamaindex
Mastra @composio/mastra —
Pi @composio/experimental* —
Cloudflare Workers AI @composio/cloudflare —
CrewAI — composio-crewai
AutoGen — composio-autogen

* The Pi provider is experimental and ships from @composio/experimental.

Don't see your framework? Build a custom provider, or skip providers entirely and connect over MCP.

All packages

Everything published from this repo:

Package Description
@composio/core TypeScript SDK
@composio/slim @composio/core without packaged source or docs; same API, smaller install
composio CLI Standalone CLI binary: curl -fsSL https://composio.dev/install | sh
@composio/experimental Experimental integrations, including the Pi provider
@composio/json-schema-to-zod JSON Schema to Zod conversion
@composio/* provider adapters OpenAI, OpenAI Agents, Anthropic, Claude Agent SDK, Vercel, Google, LangChain, LlamaIndex, Mastra, Cloudflare
composio Python SDK
composio-* provider adapters OpenAI, OpenAI Agents, Anthropic, Claude Agent SDK, Gemini, Google, Google ADK, LangChain, LangGraph, LlamaIndex, CrewAI, AutoGen

Repository layout

ts/                TypeScript SDK workspace
  packages/core/       @composio/core
  packages/providers/  Provider adapters
  packages/cli/        Composio CLI
python/            Python SDK and provider packages
docs/              Documentation site (docs.composio.dev)

The TypeScript SDK is tested against Node 22+; the Python SDK supports Python 3.10+.

Development

mise install    # pinned toolchain (Node, Python, pnpm)
pnpm install
pnpm build
pnpm test

Python commands run from python/; see python/README.md. We welcome contributions to both SDKs; read the contribution guidelines before submitting pull requests.

Support

License

MIT. See LICENSE.

composio (ComposioHQ/composio)

Searching Database…

30.6K ·GitHub
Composio
What is this?Composio is a platform for AI agents: it gives your agents 1000+ pre-authenticated toolkits, per-user sessions, auth, triggers, and a sandbox, so they can take action across apps instead of just chatting.
Is this a library I install, or a hosted service?Both: you install an SDK (@composio/core for TypeScript or composio for Python) or the standalone composio CLI, while sessions, auth, and tool execution run on Composio's hosted backend, reached with an API key.
How do I get my first agent connected?Grab a COMPOSIO_API_KEY from the dashboard, install @composio/core via npm or composio via pip, create a session, and hand its tools to your agent. For terminal-first use, install the CLI and run composio login.
Which agent frameworks does it work with?Provider adapters cover OpenAI, OpenAI Agents, Anthropic, Claude Agent SDK, Vercel AI SDK, Google GenAI, LangChain, LangGraph, LlamaIndex, Mastra, CrewAI, AutoGen, and more; any MCP client works too. The TS SDK needs Node 22+, Python needs 3.10+.
Does anything run locally, or is everything in Composio's cloud?You need a COMPOSIO_API_KEY from the hosted dashboard, and the README describes no self-hosted mode — sessions, auth, and tool execution run on Composio's cloud. The Pi provider is also explicitly experimental.
My agent's context gets bloated by tool definitions — does Composio handle that?Yes. By default a Python 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 the session id and reuse it with composio.use() across turns.
Can I use it from the shell without writing code?Yes. The composio CLI gives coding agents like Claude Code a local tool surface: composio search finds tools, execute runs them, link connects accounts, and run scripts workflows in TypeScript.
I use Cursor or Claude Desktop — can I plug it in without an SDK?Yes. Pass mcp: true to composio.create() and point Claude, Cursor, or any MCP client at the session's hosted MCP endpoint (session.mcp.url), skipping provider adapters entirely.
What's the difference between @composio/core and @composio/slim?Same API, but core intentionally packages its TypeScript source and SDK docs so the installed package is inspectable by coding agents; slim drops them for a smaller install.
What are similar projects?qwen-code, turnstone, corsair, tambo, headroom, trueforge, gitagent, harness-sdk
Which topics is it in?aiagents, js, sse, function-calling, gpt-4, llmops, agent-tools, langchain, agent-framework, coding-agents, sandbox, authentication
Creator
ComposioHQ
Size
425.4 MB
Stars
30.6K
Updated
CommitOct 16Release@composio/[email protected]Oct 15
Age
2y
Commits · 90 Days