Composio SDK · TypeScript & Python

Composable tools, integrations, and skills for AI agents — connect LLM apps to third-party APIs, SaaS products, triggers, and Model Context Protocol (MCP) workflows with typed SDKs for Node.js, Python, Vercel AI SDK, LangChain, LangGraph, LlamaIndex, OpenAI Agents, Anthropic, Google Gemini, and more.

Website · Documentation

GitHub (this copy): github.com/warpdot-dev/composio • Upstream mirror reference: ComposioHQ/composio

What this repository is

This monorepo contains the Composio SDKs for building agentic AI applications (org-hosted copy: warpdot-dev/composio): fetching toolkits, managing authentication and connected accounts, orchestrating actions across apps (email, calendars, ticketing, CRM, dev tools, etc.), and shipping production-ready integrations without hand-writing every REST client.

Use it when you are building AI agents, chatbots, automation workflows, RAG pipelines, or MCP servers that need reliable, documented access to external systems.

Table of contents

• Installation (TypeScript)
• Installation (Python)
• Quick examples
• OpenAPI specification updates
• SDK layouts
• Supported AI frameworks & providers
• Published packages
• Rube MCP server
• Contributing
• License & support

TypeScript SDK installation

npm install @composio/core
# or: yarn add @composio/core
# or: pnpm add @composio/core

Initialize the client (optionally pass apiKey from your Composio dashboard):

import { Composio } from '@composio/core';

const composio = new Composio({
  // apiKey: process.env.COMPOSIO_API_KEY,
});

Python SDK installation

Requires Python 3.10+.

pip install composio
# or: poetry add composio

from composio import Composio

composio = Composio(
  # api_key=os.environ["COMPOSIO_API_KEY"],

Quick examples (OpenAI Agents)

Minimal TypeScript / Node:

npm install @composio/openai-agents @openai/agents

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));

Minimal Python:

pip install composio_openai_agents openai-agents