# 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.

Repository: https://github.com/ComposioHQ/composio
Canonical: https://ross.abutalabs.com/products/composio
Homepage: https://docs.composio.dev
Language: TypeScript
License: MIT
License Family: permissive
Topics: ai, python, agents, aiagents, function-calling, developer-tools, gpt-4, llm, llmops, typescript, javascript, js, ai-agents, mcp, remote-mcp-server, sse, agentic-ai
Last push: 2026-08-26T21:40:45+00:00

## Health v2 (maintenance only)
Score: 88/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 65
- inputs: {"age_days": 922, "days_push": 7, "days_rel": 10, "gap_med": 0, "n_releases_24m": 692}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 29893, forks 4748 (observed 2026-08-28T04:11:53.721941+00:00)

## What it is
Composio is an SDK platform (TypeScript and Python SDKs plus a CLI) that gives AI agents access to 1000+ pre-built app toolkits with per-user authentication, tool search, triggers, and sandboxed execution. It exposes sessions with meta-tools for runtime tool discovery and offers provider adapters for OpenAI, Anthropic, LangChain, CrewAI, Vercel AI SDK, and MCP clients.

## Use cases
- give my AI agent access to Gmail, Slack, and GitHub tools
- manage OAuth authentication for multiple users in an agent app
- let my coding agent connect to SaaS apps via MCP
- find and execute app tools dynamically without loading all schemas
- build an agent that takes actions across 1000+ apps
- add triggers so my agent reacts to events like new emails
- use toolkits with LangChain or CrewAI agents

## When to choose
- you're building production AI agents that need authenticated access to many third-party apps
- you want per-user credential management handled for you instead of implementing OAuth flows
- you need runtime tool discovery to avoid stuffing hundreds of tool schemas into model context
- you use a supported framework (OpenAI Agents, LangChain, CrewAI, Vercel AI SDK) and want drop-in tool integration

## When to avoid
- you only need one or two simple API integrations you can call directly
- you require fully self-hosted infrastructure with no dependency on Composio's hosted platform and API key
- your agent runs in an environment without Node.js 22+ (for the TypeScript SDK) or network access
- you need strict data residency since tool execution and credentials flow through Composio's cloud

## Facets
- artifact type: library
- maturity: active
- function: agent-framework, auth, mcp, sdk, cli, api-framework, webhook
- domain: large-language-models, developer-tools, apis, security
- platform: python, cli, cross-platform
- tags: tool-integration, function-calling, oauth, tool-discovery, llmops, sandboxed-execution, triggers, provider-adapters, monorepo, ai-agents, automation, nodejs, typescript, web-server

## Member repositories
- ComposioHQ/composio (main) score 88

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:53.721941+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:52:52.468900+00:00, confidence not recorded.
  - readme: https://github.com/ComposioHQ/composio (fetched 2026-08-28T04:11:53.721941+00:00, sha 8fd6596a529f)
  - homepage: https://docs.composio.dev (fetched 2026-08-29T07:50:21.517671+00:00, sha 5873a30346cc)
  - site_page: https://docs.composio.dev/docs/how-composio-works (fetched 2026-08-29T07:50:21.530358+00:00, sha dab1dced2912)
  - site_page: https://docs.composio.dev/docs/configuring-sessions (fetched 2026-08-29T07:50:21.532149+00:00, sha 00c404d5a57b)
  - site_page: https://docs.composio.dev/docs/authentication (fetched 2026-08-29T07:50:21.534048+00:00, sha e0fe24d7c9f6)
  - site_page: https://docs.composio.dev/docs/quickstart (fetched 2026-08-29T07:50:21.520666+00:00, sha 12a16a37eab1)
  - site_page: https://docs.composio.dev/docs/providers (fetched 2026-08-29T07:50:21.522687+00:00, sha 04c81d9c38b8)
  - site_page: https://docs.composio.dev/docs/agent-plugins (fetched 2026-08-29T07:50:21.524455+00:00, sha 585f864f659b)
  - site_page: https://docs.composio.dev/docs/cli (fetched 2026-08-29T07:50:21.526237+00:00, sha 136f41905fd1)
  - site_page: https://docs.composio.dev/docs/composio-connect (fetched 2026-08-29T07:50:21.528594+00:00, sha b37a101e4647)
- Data as of 2026-08-30T08:39:29.467469+00:00.