Composio TypeScript providers
Each package in this directory adapts Composio tools to one agent framework's native tool format. You pass a provider to new Composio({ provider }), and session.tools() returns tools your framework can call directly.
Packages
| Package | Framework |
|---|---|
@composio/openai |
OpenAI Chat Completions and Responses APIs |
@composio/openai-agents |
OpenAI Agents SDK |
@composio/anthropic |
Anthropic Messages API |
@composio/claude-agent-sdk |
Claude Agent SDK |
@composio/vercel |
Vercel AI SDK |
@composio/google |
Google GenAI |
@composio/langchain |
LangChain and LangGraph |
@composio/llamaindex |
LlamaIndex |
@composio/mastra |
Mastra |
@composio/cloudflare |
Cloudflare Workers AI |
Each package README has an install command and a runnable quickstart.
Provider types
Providers extend one of two base classes from @composio/core:
- Non-agentic (
BaseNonAgenticProvider): format tool schemas for a raw model API (OpenAI, Anthropic, Cloudflare). Your code runs the tool loop, calling helpers likeexecuteToolCallorhandleToolCallson the provider. - Agentic (
BaseAgenticProvider): wrap tools with an execute function baked in (LangChain, LlamaIndex, Mastra, Vercel, OpenAI Agents). The framework runs the tool loop itself.
Creating a new provider
Scaffold a package from the repository root:
pnpm create:provider <provider-name> [--agentic]
This creates ts/packages/providers/<provider-name> with src/index.ts, package.json, and build config. Implement wrapTool and wrapTools (plus executeToolCall for non-agentic providers), then add tests covering wrapping and execution handling.
If you are building an adapter outside this repo, see the custom providers guide.