{ "markdown": "

\n \n \n \n \"Composio\n \n \n

\n\n

\n composio.dev •\n Documentation •\n Quickstart •\n Changelog\n

\n\n

\n \"GitHub\n \"npm\"\n \"PyPI\"\n \"Discord\"\n \"HVTrust\"\n

\n\n# Composio\n\nComposio 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.\n\nThis is the Composio SDK monorepo. It contains:\n\n- **[`@composio/core`](ts/packages/core)**: TypeScript SDK\n- **[`composio`](python)**: Python SDK\n- **[`composio` CLI](ts/packages/cli)**: search, execute, and script tools from your shell\n- **Provider adapters** for OpenAI Agents, Claude Agent SDK, Vercel AI SDK, LangChain, and [more](#providers)\n\n## Quickstart\n\nCreate 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.\n\n### TypeScript\n\n```bash\nnpm install @composio/core @composio/openai-agents @openai/agents\n```\n\n> `@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).\n\n```typescript\nimport { Composio } from \"@composio/core\";\nimport { OpenAIAgentsProvider } from \"@composio/openai-agents\";\nimport { Agent, run } from \"@openai/agents\";\n\nconst composio = new Composio({ provider: new OpenAIAgentsProvider() });\n\n// Each session is scoped to one of your users\nconst session = await composio.create(\"user_123\");\nconst tools = await session.tools();\n\nconst agent = new Agent({\n name: \"Personal Assistant\",\n instructions: \"You are a helpful assistant. Use Composio tools to take action.\",\n tools,\n});\n\nconst result = await run(agent, \"Summarize my emails from today\");\nconsole.log(result.finalOutput);\n```\n\n### Python\n\n```bash\npip install composio composio-openai-agents openai-agents\n```\n\n```python\nfrom composio import Composio\nfrom composio_openai_agents import OpenAIAgentsProvider\nfrom agents import Agent, Runner\n\ncomposio = Composio(provider=OpenAIAgentsProvider())\n\n# Each session is scoped to one of your users\nsession = composio.create(user_id=\"user_123\")\ntools = session.tools()\n\nagent = Agent(\n name=\"Personal Assistant\",\n instructions=\"You are a helpful assistant. Use Composio tools to take action.\",\n tools=tools,\n)\n\nresult = Runner.run_sync(starting_agent=agent, input=\"Summarize my emails from today\")\nprint(result.final_output)\n```\n\nBy 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.\n\n**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).\n\n## CLI\n\nThe `composio` CLI runs Composio from your shell and gives coding agents like Claude Code a local tool surface.\n\n```bash\ncurl -fsSL https://composio.dev/install | sh\n```\n\nThe 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.\n\nUse `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).\n\n## Providers\n\nA provider adapts Composio tools to your agent framework's native tool format:\n\n| Provider | TypeScript | Python |\n|----------|:----------:|:------:|\n| OpenAI | [`@composio/openai`](ts/packages/providers/openai) | [`composio-openai`](python/providers/openai) |\n| OpenAI Agents | [`@composio/openai-agents`](ts/packages/providers/openai-agents) | [`composio-openai-agents`](python/providers/openai_agents) |\n| Anthropic | [`@composio/anthropic`](ts/packages/providers/anthropic) | [`composio-anthropic`](python/providers/anthropic) |\n| Claude Agent SDK | [`@composio/claude-agent-sdk`](ts/packages/providers/claude-agent-sdk) | [`composio-claude-agent-sdk`](python/providers/claude_agent_sdk) |\n| Vercel AI SDK | [`@composio/vercel`](ts/packages/providers/vercel) | — |\n| Google GenAI | [`@composio/google`](ts/packages/providers/google) | [`composio-gemini`](python/providers/gemini), [`composio-google`](python/providers/google) |\n| Google ADK | — | [`composio-google-adk`](python/providers/google_adk) |\n| LangChain | [`@composio/langchain`](ts/packages/providers/langchain) | [`composio-langchain`](python/providers/langchain) |\n| LangGraph | via `@composio/langchain` | [`composio-langgraph`](python/providers/langgraph) |\n| LlamaIndex | [`@composio/llamaindex`](ts/packages/providers/llamaindex) | [`composio-llamaindex`](python/providers/llamaindex) |\n| Mastra | [`@composio/mastra`](ts/packages/providers/mastra) | — |\n| Pi | [`@composio/experimental`](ts/packages/experimental)* | — |\n| Cloudflare Workers AI | [`@composio/cloudflare`](ts/packages/providers/cloudflare) | — |\n| CrewAI | — | [`composio-crewai`](python/providers/crewai) |\n| AutoGen | — | [`composio-autogen`](python/providers/autogen) |\n\n\\* *The [Pi provider](https://docs.composio.dev/docs/providers/pi) is experimental and ships from `@composio/experimental`.*\n\nDon'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).\n\n## All packages\n\nEverything published from this repo:\n\n| Package | Description |\n|---------|-------------|\n| [`@composio/core`](ts/packages/core) | TypeScript SDK |\n| [`@composio/slim`](ts/packages/slim) | `@composio/core` without packaged source or docs; same API, smaller install |\n| [`composio` CLI](ts/packages/cli) | Standalone CLI binary: `curl -fsSL https://composio.dev/install \\| sh` |\n| [`@composio/experimental`](ts/packages/experimental) | Experimental integrations, including the Pi provider |\n| [`@composio/json-schema-to-zod`](ts/packages/json-schema-to-zod) | JSON Schema to Zod conversion |\n| `@composio/*` [provider adapters](#providers) | OpenAI, OpenAI Agents, Anthropic, Claude Agent SDK, Vercel, Google, LangChain, LlamaIndex, Mastra, Cloudflare |\n| [`composio`](python) | Python SDK |\n| `composio-*` [provider adapters](#providers) | OpenAI, OpenAI Agents, Anthropic, Claude Agent SDK, Gemini, Google, Google ADK, LangChain, LangGraph, LlamaIndex, CrewAI, AutoGen |\n\n## Repository layout\n\n```text\nts/ TypeScript SDK workspace\n packages/core/ @composio/core\n packages/providers/ Provider adapters\n packages/cli/ Composio CLI\npython/ Python SDK and provider packages\ndocs/ Documentation site (docs.composio.dev)\n```\n\nThe TypeScript SDK is tested against Node 22+; the Python SDK supports Python 3.10+.\n\n## Development\n\n```bash\nmise install # pinned toolchain (Node, Python, pnpm)\npnpm install\npnpm build\npnpm test\n```\n\nPython 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.\n\n## Support\n\n- [Documentation](https://docs.composio.dev)\n- [Discord community](https://discord.gg/composio)\n- [Open an issue](https://github.com/ComposioHQ/composio/issues)\n- [support@composio.dev](mailto:support@composio.dev)\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n", "bytes": 9090, "sha": "8c723e06bec36f55f3aaff4e2933834856a87dff5f6acd94f0a091b85457d94f", "repo_slug": "composiohq/composio", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/skl_composiohq_composio_composio_0d0682ce/readme" }