Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: Rewrite Anthropic provider page — Messages API only, tested agentic loop
Sushmithamallesh0b70137904a2
diff --git a/docs/content/docs/providers/anthropic.mdx b/docs/content/docs/providers/anthropic.mdxindex 0f9d364aa..b305fd63f 100644--- a/docs/content/docs/providers/anthropic.mdx+++ b/docs/content/docs/providers/anthropic.mdx@@ -1,273 +1,28 @@---title: Anthropicdescription: Build an agent with Claude and enable it to use 800+ tools with Composio.-keywords: [claude]+keywords: [claude, messages api]----## Claude Agents SDK--<ToolTypeFlow>--<ToolTypeOption id="native" name="Native Tools" icon="native">-<Steps>-<Step>-**Install**--<Tabs groupId="language" items={['Python', 'TypeScript']} persist>-<Tab value="Python">-```bash-pip install composio composio-claude-agent-sdk claude-agent-sdk-```-</Tab>-<Tab value="TypeScript">-```bash-npm install dotenv @composio/core @composio/claude-agent-sdk @anthropic-ai/claude-agent-sdk-```-</Tab>-</Tabs>-</Step>--<Step>-**Configure API Keys**--<Callout type="info">-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `ANTHROPIC_API_KEY` with your [Anthropic API key](https://console.anthropic.com/settings/keys).-</Callout>--```txt title=".env"-COMPOSIO_API_KEY=xxxxxxxxx-ANTHROPIC_API_KEY=xxxxxxxxx-```-</Step>--<Step>-**Create session and run agent**--<Tabs groupId="language" items={['Python', 'TypeScript']} persist>-<Tab value="Python">-```python-import asyncio-from dotenv import load_dotenv-load_dotenv()--from composio import Composio-from composio_claude_agent_sdk import ClaudeAgentSDKProvider-from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, create_sdk_mcp_server--# Initialize Composio with Claude Agent SDK provider-composio = Composio(provider=ClaudeAgentSDKProvider())--external_user_id = "user_2nFh83Hde"-recipient_email = "[email protected]"--# Create a session-session = composio.create(user_id=external_user_id)--# Get tools from the session-tools = session.tools()-custom_server = create_sdk_mcp_server(name="composio", version="1.0.0", tools=tools)--# Run the agent-async def main():- options = ClaudeAgentOptions(- system_prompt="You are a helpful assistant.",- permission_mode="bypassPermissions",- mcp_servers={"composio": custom_server},- )-- async with ClaudeSDKClient(options=options) as client:- await client.query(f"Send an email to {recipient_email} with the subject 'Hello from Composio' and the body 'This is a test email!'")- async for msg in client.receive_response():- print(msg)--asyncio.run(main())-```-</Tab>-<Tab value="TypeScript">-```typescript-import "dotenv/config";-import { Composio } from "@composio/core";-import { ClaudeAgentSDKProvider } from "@composio/claude-agent-sdk";-import { createSdkMcpServer, query } from "@anthropic-ai/claude-agent-sdk";--// Initialize Composio with Claude Agent SDK provider-const composio = new Composio({- provider: new ClaudeAgentSDKProvider(),-});--const externalUserId = "user_2nFh83Hde";-const recipientEmail = "[email protected]";--// Create a session-const session = await composio.create(externalUserId);--// Get tools from the session-const tools = await session.tools();--const customServer = createSdkMcpServer({- name: "composio",- version: "1.0.0",- tools: tools,-});--// Run the agent-console.log("Running agent...");-for await (const content of query({- prompt: `Send an email to ${recipientEmail} with the subject 'Hello from Composio' and the body 'This is a test email!'`,- options: {- mcpServers: { composio: customServer },- permissionMode: "bypassPermissions",- },-})) {- if (content.type === "assistant") {- console.log("Claude:", content.message);- }-}--console.log("Received response from Claude");-```-</Tab>-</Tabs>-</Step>-</Steps>-</ToolTypeOption>--<ToolTypeOption id="mcp" name="MCP" icon="mcp">-<Steps>-<Step>-**Install**--<Tabs groupId="language" items={['Python', 'TypeScript']} persist>-<Tab value="Python">-```bash-pip install composio claude-agent-sdk-```-</Tab>-<Tab value="TypeScript">-```bash-npm install dotenv @composio/core @anthropic-ai/claude-agent-sdk-```-</Tab>-</Tabs>-</Step>--<Step>-**Configure API Keys**+The Anthropic Provider transforms Composio tools into a format compatible with the [Claude Messages API](https://docs.anthropic.com/en/api/messages).<Callout type="info">-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `ANTHROPIC_API_KEY` with your [Anthropic API key](https://console.anthropic.com/settings/keys).+Looking for the Claude Agent SDK? See the [Claude Agent SDK](/docs/providers/claude-agent-sdk) provider page.</Callout>-```txt title=".env"-COMPOSIO_API_KEY=xxxxxxxxx-ANTHROPIC_API_KEY=xxxxxxxxx-```-</Step>--<Step>-**Create session and run agent**--<Tabs groupId="language" items={['Python', 'TypeScript']} persist>-<Tab value="Python">-```python-import asyncio-from dotenv import load_dotenv-load_dotenv()--from composio import Composio-from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions--# Initialize Composio-composio = Composio()--external_user_id = "user_2nFh83Hde"-recipient_email = "[email protected]"--# Create a session-session = composio.create(user_id=external_user_id)--# Run the agent-async def main():- options = ClaudeAgentOptions(- system_prompt="You are a helpful assistant.",- permission_mode="bypassPermissions",- mcp_servers={- "composio": {- "type": "http",- "url": session.mcp.url,- "headers": session.mcp.headers,- }- },- )-- async with ClaudeSDKClient(options=options) as client:- await client.query(f"Send an email to {recipient_email} with the subject 'Hello from Composio' and the body 'This is a test email!'")- async for msg in client.receive_response():- print(msg)--asyncio.run(main())-```-</Tab>-<Tab value="TypeScript">-```typescript-import "dotenv/config";-import { Composio } from "@composio/core";-import { query } from "@anthropic-ai/claude-agent-sdk";--// Initialize Composio-const composio = new Composio();--const externalUserId = "user_2nFh83Hde";-const recipientEmail = "[email protected]";--// Create a session-const session = await composio.create(externalUserId);--// Run the agent-console.log("Running agent...");-for await (const content of query({- prompt: `Send an email to ${recipientEmail} with the subject 'Hello from Composio' and the body 'This is a test email!'`,- options: {- mcpServers: {- composio: {- type: "http",- url: session.mcp.url,- headers: session.mcp.headers,- },- },- permissionMode: "bypassPermissions",- },-})) {- if (content.type === "assistant") {- console.log("Claude:", content.message);- }-}--console.log("Received response from Claude");-```-</Tab>-</Tabs>-</Step>-</Steps>-</ToolTypeOption>--</ToolTypeFlow>--## Anthropic API-<Steps><Step>**Install**-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>+<Tabs groupId="language" items={["Python", "TypeScript"]} persist><Tab value="Python">```bash-pip install composio composio-anthropic anthropic+pip install composio composio_anthropic anthropic```</Tab><Tab value="TypeScript">```bash-npm install dotenv @composio/core @composio/anthropic @anthropic-ai/sdk+npm install @composio/core @composio/anthropic @anthropic-ai/sdk```</Tab></Tabs>@@ -287,87 +42,119 @@ ANTHROPIC_API_KEY=xxxxxxxxx</Step><Step>-**Create session and run agent**+**Create session and run**-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>+<Tabs groupId="language" items={["Python", "TypeScript"]} persist><Tab value="Python">```python+import jsonimport anthropic-from dotenv import load_dotenv-load_dotenv()-from composio import Composiofrom composio_anthropic import AnthropicProvider-# Initialize Composio with Anthropic provider-anthropic_client = anthropic.Anthropic()composio = Composio(provider=AnthropicProvider())+client = anthropic.Anthropic()-external_user_id = "user_2nFh83Hde"-recipient_email = "[email protected]"--# Create a session-session = composio.create(user_id=external_user_id)--# Get tools from the session+# Create a session for your user+session = composio.create(user_id="user_123")tools = session.tools()-# Get response from the LLM-response = anthropic_client.messages.create(- model="claude-sonnet-4-5",- max_tokens=1024,+messages = [+ {"role": "user", "content": "Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'"}+]++response = client.messages.create(+ model="claude-sonnet-4-5-20250929",+ max_tokens=4096,tools=tools,- messages=[- {"role": "user", "content": f"Send an email to {recipient_email} with the subject 'Hello from Composio' and the body 'This is a test email!'"},- ],+ messages=messages,)-# Execute the function calls-result = composio.provider.handle_tool_calls(user_id=external_user_id, response=response)-print(result)+# Agentic loop — keep executing tool calls until the model responds with text+while response.stop_reason == "tool_use":+ tool_use_blocks = [block for block in response.content if block.type == "tool_use"]+ results = composio.provider.handle_tool_calls(user_id="user_123", response=response)+ messages.append({"role": "assistant", "content": response.content})+ messages.append({+ "role": "user",+ "content": [+ {"type": "tool_result", "tool_use_id": tool_use_blocks[i].id, "content": json.dumps(result)}+ for i, result in enumerate(results)+ ]+ })+ response = client.messages.create(+ model="claude-sonnet-4-5-20250929",+ max_tokens=4096,+ tools=tools,+ messages=messages,+ )++# Print final response+for block in response.content:+ if hasattr(block, "text"):+ print(block.text)```</Tab><Tab value="TypeScript">```typescript-import "dotenv/config";-import { Composio } from "@composio/core";-import { AnthropicProvider } from "@composio/anthropic";-import Anthropic from "@anthropic-ai/sdk";+import Anthropic from '@anthropic-ai/sdk';+import { Composio } from '@composio/core';+import { AnthropicProvider } from '@composio/anthropic';-// Initialize Composio with Anthropic providerconst composio = new Composio({- provider: new AnthropicProvider(),+ provider: new AnthropicProvider(),});-const anthropic = new Anthropic();--const externalUserId = "user_2nFh83Hde";-const recipientEmail = "[email protected]";+const client = new Anthropic();-// Create a session-const session = await composio.create(externalUserId);--// Get tools from the session+// Create a session for your user+const session = await composio.create("user_123");const tools = await session.tools();-// Get response from the LLM-const msg = await anthropic.messages.create({- model: "claude-sonnet-4-5",- messages: [+const messages: Anthropic.MessageParam[] = [{- role: "user",- content: `Send an email to ${recipientEmail} with the subject 'Hello from Composio' and the body 'This is a test email!'`,+ role: "user",+ content: "Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'"},- ],- tools: tools,- max_tokens: 1000,+];++let response = await client.messages.create({+ model: "claude-sonnet-4-5-20250929",+ max_tokens: 4096,+ tools: tools,+ messages: messages,});-// Execute the function calls-const result = await composio.provider.handleToolCalls(externalUserId, msg);-console.log(result);+// Agentic loop — keep executing tool calls until the model responds with text+while (response.stop_reason === "tool_use") {+ const toolUseBlocks = response.content.filter(+ (block): block is Anthropic.ToolUseBlock => block.type === "tool_use"+ );+ const results = await composio.provider.handleToolCalls("user_123", response);+ messages.push({ role: "assistant", content: response.content });+ messages.push({+ role: "user",+ content: results.map((result, i) => ({+ type: "tool_result" as const,+ tool_use_id: toolUseBlocks[i].id,+ content: JSON.stringify(result),+ })),+ });+ response = await client.messages.create({+ model: "claude-sonnet-4-5-20250929",+ max_tokens: 4096,+ tools: tools,+ messages: messages,+ });+}++// Print final response+for (const block of response.content) {+ if (block.type === "text") {+ console.log(block.text);+ }+}```</Tab></Tabs></Step></Steps>-