Composio

Active
GitHub TypeScript MIT

Description

Composio is a tools and SaaS integration layer for agents, helping applications connect quickly to services like Gmail, Slack, and GitHub for multi-tool workflows.

Key Features

  • Unified tool integration layer — connect to Gmail, Slack, GitHub and 200+ SaaS services via a single SDK
  • Multi-framework providers — supports OpenAI, Anthropic, LangChain, LlamaIndex, CrewAI and 12+ AI frameworks
  • Python + TypeScript dual language — fully typed TS SDK and Pythonic Python SDK
  • User-level tool isolation — isolate tool permissions by user_id for multi-tenant agent scenarios
  • Custom providers — extensible mechanism to integrate any AI framework beyond the official list
  • OpenAPI-driven — auto-pull backend OpenAPI specs with pnpm api:pull to generate SDK docs

Use Cases

💡 Agent email automation — agents read, reply, forward Gmail and execute follow-up actions
💡 GitHub code review agent — agent auto-fetches PRs, analyzes diffs, and generates review comments
💡 Slack information sync — agent posts messages, reads discussions, and summarizes key info in Slack channels
💡 Cross-platform data aggregation — pull data from multiple SaaS services, analyze with LLM, generate reports
💡 Enterprise RPA replacement — describe tasks in natural language, agent executes multi-step API operations

Quick Start

# TypeScript setup
npm install @composio/core @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 tools = await composio.tools.get('user@acme.org', { toolkits: ['HACKERNEWS'] });
const agent = new Agent({ name: 'HN Agent', tools });
const result = await run(agent, 'What is the latest hackernews post about?');
console.log(result.finalOutput);

Related Projects