Skip to content
Back to search

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/composiohq/composio with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/composiohq/composio'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/composiohq-composio/badge.svg)](/listings/composiohq-composio)

HTML

<a href="/listings/composiohq-composio"><img src="/api/listings/composiohq-composio/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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](https://dashboard.composio.dev/settings) 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`](ts/packages/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](https://docs.composio.dev/docs/how-composio-works) and [configuring sessions](https://docs.composio.dev/docs/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](https://docs.composio.dev/docs/sessions-via-mcp).

About

Found in: claude-skills-marketplace

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 187 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <a href="https://composio.dev">
  3. <picture>
  4. <source media="(prefers-color-scheme: dark)" srcset="https://brand.composio.dev/logos/Logomark-White.svg">
  5. <img alt="Composio logo" src="https://brand.composio.dev/logos/Logomark-Black.svg" width="96">
  6. </picture>
  7. </a>
  8. </p>
  9. <p align="center">
  10. <a href="https://composio.dev"><b>composio.dev</b></a> •
  11. <a href="https://docs.composio.dev">Documentation</a> •
  12. <a href="https://docs.composio.dev/docs/quickstart">Quickstart</a> •
  13. <a href="https://docs.composio.dev/reference/changelog">Changelog</a>
  14. </p>
  15. <p align="center">
  16. <a href="https://github.com/ComposioHQ/composio/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/ComposioHQ/composio?style=social" /></a>
  17. <a href="https://www.npmjs.com/package/@composio/core"><img alt="npm" src="https://img.shields.io/npm/v/@composio/core?label=%40composio%2Fcore" /></a>
  18. <a href="https://pypi.org/project/composio/"><img alt="PyPI" src="https://img.shields.io/pypi/v/composio?label=composio" /></a>
  19. <a href="https://discord.gg/composio"><img alt="Discord" src="https://img.shields.io/badge/discord-community-5865F2?logo=discord&logoColor=white" /></a>
  20. <a href="https://hvtracker.net/agents/composio/"><img alt="HVTrust" src="https://hvtracker.net/badge/composio.svg" /></a>
  21. </p>
  22. # Composio
  23. 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.
  24. This is the Composio SDK monorepo. It contains:
  25. - **[`@composio/core`](ts/packages/core)**: TypeScript SDK
  26. - **[`composio`](python)**: Python SDK
  27. - **[`composio` CLI](ts/packages/cli)**: search, execute, and script tools from your shell
  28. - **Provider adapters** for OpenAI Agents, Claude Agent SDK, Vercel AI SDK, LangChain, and [more](#providers)
  29. ## Quickstart
  30. 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](https://dashboard.composio.dev/settings) first.
  31. ### TypeScript
  32. ```bash
  33. npm install @composio/core @composio/openai-agents @openai/agents
  34. ```
  35. > `@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`](ts/packages/slim).
  36. ```typescript
  37. import { Composio } from "@composio/core";
  38. import { OpenAIAgentsProvider } from "@composio/openai-agents";
  39. import { Agent, run } from "@openai/agents";
  40. const composio = new Composio({ provider: new OpenAIAgentsProvider() });
  41. // Each session is scoped to one of your users
  42. const session = await composio.create("user_123");
  43. const tools = await session.tools();
  44. const agent = new Agent({
  45. name: "Personal Assistant",
  46. instructions: "You are a helpful assistant. Use Composio tools to take action.",
  47. tools,
  48. });
  49. const result = await run(agent, "Summarize my emails from today");
  50. console.log(result.finalOutput);
  51. ```
  52. ### Python
  53. ```bash
  54. pip install composio composio-openai-agents openai-agents
  55. ```
  56. ```python
  57. from composio import Composio
  58. from composio_openai_agents import OpenAIAgentsProvider
  59. from agents import Agent, Runner
  60. composio = Composio(provider=OpenAIAgentsProvider())
  61. # Each session is scoped to one of your users
  62. session = composio.create(user_id="user_123")
  63. tools = session.tools()
  64. agent = Agent(
  65. name="Personal Assistant",
  66. instructions="You are a helpful assistant. Use Composio tools to take action.",
  67. tools=tools,
  68. )
  69. result = Runner.run_sync(starting_agent=agent, input="Summarize my emails from today")
  70. print(result.final_output)
  71. ```
  72. 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](https://docs.composio.dev/docs/how-composio-works) and [configuring sessions](https://docs.composio.dev/docs/configuring-sessions) for restricting toolkits, auth configs, and connected accounts.
  73. **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](https://docs.composio.dev/docs/sessions-via-mcp).
  74. ## CLI
  75. The `composio` CLI runs Composio from your shell and gives coding agents like Claude Code a local tool surface.
  76. ```bash
  77. curl -fsSL https://composio.dev/install | sh
  78. ```
  79. The installer puts `composio` on your `PATH` for future terminals. Open a new terminal, then run `composio login`. See [INSTALL.md](INSTALL.md) for shell setup overrides, including `COMPOSIO_INSTALL_SHELL=none` for install-only runs.
  80. 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](https://docs.composio.dev/docs/cli).
  81. ## Providers
  82. A provider adapts Composio tools to your agent framework's native tool format:
  83. | Provider | TypeScript | Python |
  84. |----------|:----------:|:------:|
  85. | OpenAI | [`@composio/openai`](ts/packages/providers/openai) | [`composio-openai`](python/providers/openai) |
  86. | OpenAI Agents | [`@composio/openai-agents`](ts/packages/providers/openai-agents) | [`composio-openai-agents`](python/providers/openai_agents) |
  87. | Anthropic | [`@composio/anthropic`](ts/packages/providers/anthropic) | [`composio-anthropic`](python/providers/anthropic) |
  88. | Claude Agent SDK | [`@composio/claude-agent-sdk`](ts/packages/providers/claude-agent-sdk) | [`composio-claude-agent-sdk`](python/providers/claude_agent_sdk) |
  89. | Vercel AI SDK | [`@composio/vercel`](ts/packages/providers/vercel) | — |
  90. | Google GenAI | [`@composio/google`](ts/packages/providers/google) | [`composio-gemini`](python/providers/gemini), [`composio-google`](python/providers/google) |
  91. | Google ADK | — | [`composio-google-adk`](python/providers/google_adk) |
  92. | LangChain | [`@composio/langchain`](ts/packages/providers/langchain) | [`composio-langchain`](python/providers/langchain) |
  93. | LangGraph | via `@composio/langchain` | [`composio-langgraph`](python/providers/langgraph) |
  94. | LlamaIndex | [`@composio/llamaindex`](ts/packages/providers/llamaindex) | [`composio-llamaindex`](python/providers/llamaindex) |
  95. | Mastra | [`@composio/mastra`](ts/packages/providers/mastra) | — |
  96. | Pi | [`@composio/experimental`](ts/packages/experimental)* | — |
  97. | Cloudflare Workers AI | [`@composio/cloudflare`](ts/packages/providers/cloudflare) | — |
  98. | TypeSafe (Jev) | [`@composio/typesafe`](ts/packages/providers/typesafe) | [`composio-typesafe`](python/providers/typesafe) |
  99. | CrewAI | — | [`composio-crewai`](python/providers/crewai) |
  100. | AutoGen | — | [`composio-autogen`](python/providers/autogen) |
  101. \* *The [Pi provider](https://docs.composio.dev/docs/providers/pi) is experimental and ships from `@composio/experimental`.*
  102. Don't see your framework? [Build a custom provider](https://docs.composio.dev/docs/providers/custom-providers), or skip providers entirely and connect over [MCP](https://docs.composio.dev/docs/sessions-via-mcp).
  103. ## All packages
  104. Everything published from this repo:
  105. | Package | Description |
  106. |---------|-------------|
  107. | [`@composio/core`](ts/packages/core) | TypeScript SDK |
  108. | [`@composio/slim`](ts/packages/slim) | `@composio/core` without packaged source or docs; same API, smaller install |
  109. | [`composio` CLI](ts/packages/cli) | Standalone CLI binary: `curl -fsSL https://composio.dev/install \| sh` |
  110. | [`@composio/experimental`](ts/packages/experimental) | Experimental integrations, including the Pi provider |
  111. | [`@composio/json-schema-to-zod`](ts/packages/json-schema-to-zod) | JSON Schema to Zod conversion |
  112. | `@composio/*` [provider adapters](#providers) | OpenAI, OpenAI Agents, Anthropic, Claude Agent SDK, Vercel, Google, LangChain, LlamaIndex, Mastra, Cloudflare, TypeSafe |
  113. | [`composio`](python) | Python SDK |
  114. | `composio-*` [provider adapters](#providers) | OpenAI, OpenAI Agents, Anthropic, Claude Agent SDK, Gemini, Google, Google ADK, LangChain, LangGraph, LlamaIndex, CrewAI, AutoGen, TypeSafe |
  115. ## Repository layout
  116. ```text
  117. ts/ TypeScript SDK workspace
  118. packages/core/ @composio/core
  119. packages/providers/ Provider adapters
  120. packages/cli/ Composio CLI
  121. python/ Python SDK and provider packages
  122. docs/ Documentation site (docs.composio.dev)
  123. ```
  124. The TypeScript SDK is tested against Node 22+; the Python SDK supports Python 3.11+.
  125. ## Development
  126. ```bash
  127. mise install # pinned toolchain (Node, Python, pnpm)
  128. pnpm install
  129. pnpm build
  130. pnpm test
  131. ```
  132. Python commands run from `python/`; see [`python/README.md`](python/README.md). We welcome contributions to both SDKs; read the [contribution guidelines](CONTRIBUTING.md) before submitting pull requests.
  133. ## Support
  134. - [Documentation](https://docs.composio.dev)
  135. - [Discord community](https://discord.gg/composio)
  136. - [Open an issue](https://github.com/ComposioHQ/composio/issues)
  137. - [support@composio.dev](mailto:support@composio.dev)
  138. ## License
  139. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.