Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

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.mdx
index 0f9d364aa..b305fd63f 100644
--- a/docs/content/docs/providers/anthropic.mdx
+++ b/docs/content/docs/providers/anthropic.mdx
@@ -1,273 +1,28 @@
---
title: Anthropic
description: 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 json
import anthropic
-from dotenv import load_dotenv
-load_dotenv()
-
from composio import Composio
from 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 provider
const 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>
-