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: Python snippets fix tool router

Sushmithamallesh88229dbd6ef2
diff --git a/fern/pages/src/tool-router/quickstart.mdx b/fern/pages/src/tool-router/quickstart.mdx
index 435600023..06d3a086a 100644
--- a/fern/pages/src/tool-router/quickstart.mdx
+++ b/fern/pages/src/tool-router/quickstart.mdx
@@ -18,7 +18,7 @@ Choose how you want to integrate Tool Router:
<Step title="Install">
<CodeGroup>
```bash title="Python" for="python"
-pip install composio claude-agent-sdk
+pip install python-dotenv composio claude-agent-sdk
```
```bash title="TypeScript" for="typescript"
npm install @composio/core @anthropic-ai/claude-agent-sdk
@@ -52,7 +52,7 @@ When the agent needs authentication, it will prompt the user with a link to conn
<Step title="Install">
<CodeGroup>
```bash title="Python" for="python"
-pip install composio openai-agents
+pip install python-dotenv composio openai-agents
```
```bash title="TypeScript" for="typescript"
npm install @composio/core @openai/agents
@@ -127,7 +127,7 @@ When you run this agent, Tool Router:
<Step title="Install">
<CodeGroup>
```bash title="Python" for="python"
-pip install composio composio-openai-agents openai-agents
+pip install python-dotenv composio composio-openai-agents openai-agents
```
```bash title="TypeScript" for="typescript"
npm install @composio/core @composio/openai-agents @openai/agents
diff --git a/fern/pages/src/tool-router/using-as-a-native-tool.mdx b/fern/pages/src/tool-router/using-as-a-native-tool.mdx
index 8a2517d92..3334cf5a0 100644
--- a/fern/pages/src/tool-router/using-as-a-native-tool.mdx
+++ b/fern/pages/src/tool-router/using-as-a-native-tool.mdx
@@ -19,7 +19,7 @@ Jump to examples for:
<CodeGroup>
```bash title="Python" for="python"
-pip install composio composio-openai-agents openai-agents
+pip install python-dotenv composio composio-openai-agents openai-agents
```
```bash title="TypeScript" for="typescript"
npm install @composio/core @composio/openai-agents @openai/agents
diff --git a/fern/pages/src/tool-router/using-with-mcp-clients.mdx b/fern/pages/src/tool-router/using-with-mcp-clients.mdx
index 5a9736b39..a247975ac 100644
--- a/fern/pages/src/tool-router/using-with-mcp-clients.mdx
+++ b/fern/pages/src/tool-router/using-with-mcp-clients.mdx
@@ -20,7 +20,7 @@ Jump to examples for:
<CodeGroup>
```bash title="Python" for="python"
-pip install composio claude-agent-sdk
+pip install python-dotenv composio claude-agent-sdk
```
```bash title="TypeScript" for="typescript"
npm install @composio/core @anthropic-ai/claude-agent-sdk
@@ -47,7 +47,7 @@ Create a Tool Router session and execute tasks with Claude:
<CodeGroup>
```bash title="Python" for="python"
-pip install composio openai-agents
+pip install python-dotenv composio openai-agents
```
```bash title="TypeScript" for="typescript"
npm install @composio/core @openai/agents
@@ -59,8 +59,8 @@ npm install @composio/core @openai/agents
Create a Tool Router session and execute tasks with OpenAI agents:
<Info>
-- Set your `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).
-- Set your `OPENAI_API_KEY` environment variable with your [OpenAI API key](https://platform.openai.com/api-keys).
+- Set `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).
+- Set `OPENAI_API_KEY` environment variable with your [OpenAI API key](https://platform.openai.com/api-keys).
</Info>
<CodeGroup>
@@ -81,8 +81,8 @@ npm install @composio/core ai @ai-sdk/anthropic @ai-sdk/mcp
Use Tool Router with Vercel AI SDK's `generateText` for single completions:
<Info>
-- Set your `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).
-- Set your `ANTHROPIC_API_KEY` environment variable with your [Anthropic API key](https://platform.claude.com/settings/keys).
+- Set `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).
+- Set `ANTHROPIC_API_KEY` environment variable with your [Anthropic API key](https://platform.claude.com/settings/keys).
</Info>
<SnippetCode src="fern/snippets/tool-router/typescript/mcp-vercel.ts" />
\ No newline at end of file
diff --git a/fern/snippets/tool-router/python/mcp-claude.py b/fern/snippets/tool-router/python/mcp-claude.py
index fd4d16550..88379299a 100644
--- a/fern/snippets/tool-router/python/mcp-claude.py
+++ b/fern/snippets/tool-router/python/mcp-claude.py
@@ -1,67 +1,69 @@
import asyncio
-import os
from dotenv import load_dotenv
from claude_agent_sdk.client import ClaudeSDKClient
-from claude_agent_sdk.types import ClaudeAgentOptions, AssistantMessage, TextBlock, ToolUseBlock
+from claude_agent_sdk.types import (
+ ClaudeAgentOptions,
+ AssistantMessage,
+ TextBlock,
+ ToolUseBlock,
+)
from composio import Composio
load_dotenv()
-# Initialize Composio and create a Tool Router session
-composio = Composio(api_key=os.environ["COMPOSIO_API_KEY"])
-user_id = "user_123" # Your user's unique identifier
+# Initialize Composio (API key from env var COMPOSIO_API_KEY or pass explicitly)
+composio = Composio()
+
+# Unique identifier of the user
+user_id = "user_123"
+# Create a tool router session for the user
session = composio.create(user_id=user_id)
# Configure Claude with Composio MCP server
options = ClaudeAgentOptions(
- system_prompt=("You are a helpful assistant with access to external tools. "
- "Always use the available tools to complete user requests."),
+ system_prompt=(
+ "You are a helpful assistant with access to external tools. "
+ "Always use the available tools to complete user requests."
+ ),
mcp_servers={
"composio": {
"type": "http",
"url": session.mcp.url,
- "headers": {"x-api-key": os.environ["COMPOSIO_API_KEY"]},
+ "headers": session.mcp.headers, # Authentication headers for the Composio MCP server
}
},
- permission_mode="bypassPermissions",
+ permission_mode="bypassPermissions", # Auto-approve tools (demo only)
)
-
async def main():
- print("Starting Claude agent with Composio Tool Router...\n")
-
- async with ClaudeSDKClient(options) as client:
- # Initial task
- query = ("Fetch all open issues from the composio GitHub repository "
- "and create a Google Sheet with issue number, title, labels, and author")
-
- print(f"Task: {query}\n")
- print("Claude: ", end="")
-
- await client.query(query)
- async for msg in client.receive_response():
- if isinstance(msg, AssistantMessage):
- for block in msg.content:
- if isinstance(block, ToolUseBlock):
- print(f"\n[🔧 Using tool: {block.name}]")
- elif isinstance(block, TextBlock):
- print(block.text, end="")
- print("\n")
-
- # If authentication is needed, Claude will provide a link
- # You can paste it back or type 'quit' to exit
- user_input = input("\nYou (confirm connection or new task or quit): ").strip()
-
- if user_input.lower() not in ("quit", "exit") and user_input:
- await client.query(user_input)
- print("\nClaude: ", end="")
- async for msg in client.receive_response():
- if isinstance(msg, AssistantMessage):
- for block in msg.content:
- if isinstance(block, TextBlock):
- print(block.text, end="")
- print()
+ print("""
+What task would you like me to help you with?
+I can use tools like Gmail, GitHub, Linear, Notion, and more.
+(Type 'exit' to exit)
+Example tasks:
+ • 'Summarize my emails from today'
+ • 'List all open issues on the composio github repository and create a notion page with the issues'
+""")
+ async with ClaudeSDKClient(options) as client:
+ # Multi-turn conversation with agentic tool calling
+ while True:
+ user_input = input("\nYou: ").strip()
+ if user_input.lower() == "exit":
+ break
+
+ print("\nClaude: ", end="", flush=True)
+ try:
+ await client.query(user_input)
+ async for msg in client.receive_response():
+ if isinstance(msg, AssistantMessage):
+ for block in msg.content:
+ if isinstance(block, ToolUseBlock):
+ print(f"\n[Using tool: {block.name}]", end="")
+ elif isinstance(block, TextBlock):
+ print(block.text, end="", flush=True)
+ except Exception as e:
+ print(f"\n[Error]: {e}")
if __name__ == "__main__":
asyncio.run(main())
\ No newline at end of file
diff --git a/fern/snippets/tool-router/python/mcp-openai.py b/fern/snippets/tool-router/python/mcp-openai.py
index c68472bd5..fed9c1560 100644
--- a/fern/snippets/tool-router/python/mcp-openai.py
+++ b/fern/snippets/tool-router/python/mcp-openai.py
@@ -1,28 +1,22 @@
-import os
from dotenv import load_dotenv
from composio import Composio
-from agents import Agent, Runner, HostedMCPTool, ModelSettings
+from agents import Agent, Runner, HostedMCPTool
-# Load environment variables from .env file
load_dotenv()
-composio_api_key = os.environ["COMPOSIO_API_KEY"]
-user_id = "user_123" # Your user's unique identifier
+# Initialize Composio (API key from env var COMPOSIO_API_KEY)
+composio = Composio()
+# Unique identifier of the user
+user_id = "user_123"
-print("Starting OpenAI agent with Composio...\n")
-
-# Initialize Composio and create a Tool Router session
-composio = Composio(api_key=composio_api_key)
+# Create a Tool Router session for the user
session = composio.create(user_id=user_id)
# Configure OpenAI agent with Composio MCP server
agent = Agent(
- name="AI Assistant",
- instructions=(
- "You are a helpful assistant with access to external tools. "
- "Always use the available tools to complete user requests instead of just explaining how to do them."
- ),
- model="gpt-5.2",
+ name="Personal Assistant",
+ instructions="You are a helpful personal assistant. Use Composio tools to take action.",
+ model="gpt-5.2",
tools=[
HostedMCPTool(
tool_config={
@@ -30,24 +24,22 @@ agent = Agent(
"server_label": "composio",
"server_url": session.mcp.url,
"require_approval": "never",
- "headers": {"x-api-key": composio_api_key},
+ "headers": session.mcp.headers,
}
)
],
)
-# Optional: Pre-authorize tools before use (otherwise you'll get a link during execution)
-# connection_request = session.authorize("github")
-# print(connection_request.redirect_url)
-# connected_account = connection_request.wait_for_connection(timeout=60000)
-# print(f"Connected: {connected_account.id}")
-
-print("Running the OpenAI agent to fetch GitHub issues...\n")
-
-# Execute a task that requires GitHub access
-result = Runner.run_sync(
- starting_agent=agent,
- input=("Fetch all the open GitHub issues on the composio repository "
- "and group them by bugs/features/docs.")
-)
-print(f"Result: {result.final_output}")
\ No newline at end of file
+# Execute the task
+print("Fetching GitHub issues from the Composio repository @ComposioHQ/composio...\n")
+try:
+ result = Runner.run_sync(
+ starting_agent=agent,
+ input="Fetch all the open GitHub issues on the composio repository and group them by bugs/features/docs.",
+ )
+ print(result.final_output)
+except Exception as e:
+ print(f"[Error]: {e}")
+
+print("\n\n---")
+print("Tip: If prompted to authenticate, complete the auth flow and run again.")
\ No newline at end of file
diff --git a/fern/snippets/tool-router/python/native-tools-openai.py b/fern/snippets/tool-router/python/native-tools-openai.py
index c0b4d2b2e..f6e5833ac 100644
--- a/fern/snippets/tool-router/python/native-tools-openai.py
+++ b/fern/snippets/tool-router/python/native-tools-openai.py
@@ -1,51 +1,54 @@
-import os
from dotenv import load_dotenv
from composio import Composio
from agents import Agent, Runner, SQLiteSession
from composio_openai_agents import OpenAIAgentsProvider
-# Load environment variables from .env file
load_dotenv()
-composio = Composio(api_key=os.environ.get("COMPOSIO_API_KEY"), provider=OpenAIAgentsProvider())
-session = composio.create(user_id="user_123")
+# Initialize Composio with OpenAI Agents provider (API key from env var COMPOSIO_API_KEY)
+composio = Composio(provider=OpenAIAgentsProvider())
-# Get native tools from Composio
+# Unique identifier of the user
+user_id = "user_123"
+
+# Create a session and get native tools for the user
+session = composio.create(user_id=user_id)
tools = session.tools()
-# Create OpenAI agent with Composio tools
+# Configure OpenAI agent with Composio tools
agent = Agent(
- name="AI Assistant",
- instructions="You are a helpful assistant with access to external tools. Always use the available tools to complete user requests instead of just explaining how to do them.",
- model="gpt-5.2",
+ name="Personal Assistant",
+ instructions="You are a helpful personal assistant. Use Composio tools to take action.",
+ model="gpt-4o",
tools=tools,
)
-# Create session for multi-turn conversation
-conversation_session = SQLiteSession("conversation_example")
+# Memory for multi-turn conversation
+memory = SQLiteSession("conversation")
-# Execute an initial task that requires GitHub access
-print("Executing initial task: Fetching GitHub issues...\n")
-result = Runner.run_sync(
- starting_agent=agent,
- input="Fetch all the open GitHub issues on the composio repository and group them by bugs/features/docs.",
- session=conversation_session,
-)
-print(f"Result: {result.final_output}\n")
+# Execute an initial task
+print("Fetching GitHub issues from the Composio repository...\n")
+try:
+ result = Runner.run_sync(
+ starting_agent=agent,
+ input="Fetch all the open GitHub issues on the @ComposioHQ/composio repository and group them by bugs/features/docs.",
+ session=memory,
+ )
+ print(f"{result.final_output}\n")
+except Exception as e:
+ print(f"[Error]: {e}")
# Continue with interactive conversation
-print("Assistant: What else would you like me to do? Type 'exit' to end the conversation.\n")
+print("\nWhat else would you like me to do? (Type 'exit' to exit)")
while True:
- user_input = input("> ")
+ user_input = input("You: ").strip()
if user_input.lower() == "exit":
break
-
- # Run agent with session to maintain context
- result = Runner.run_sync(
- starting_agent=agent,
- input=user_input,
- session=conversation_session,
- )
-
- print(f"Assistant: {result.final_output}\n")
\ No newline at end of file
+
+ print("Assistant: ", end="", flush=True)
+ try:
+ result = Runner.run_sync(starting_agent=agent, input=user_input, session=memory)
+ print(f"{result.final_output}\n")
+ except Exception as e:
+ print(f"\n[Error]: {e}")
\ No newline at end of file
diff --git a/fern/snippets/tool-router/python/quickstart-mcp-claude.py b/fern/snippets/tool-router/python/quickstart-mcp-claude.py
index 4539b315a..f0af4e4fd 100644
--- a/fern/snippets/tool-router/python/quickstart-mcp-claude.py
+++ b/fern/snippets/tool-router/python/quickstart-mcp-claude.py
@@ -1,35 +1,36 @@
import asyncio
-import os
from dotenv import load_dotenv
from claude_agent_sdk.client import ClaudeSDKClient
from claude_agent_sdk.types import (
- ClaudeAgentOptions,
- ResultMessage,
- AssistantMessage,
- TextBlock,
- ToolUseBlock
+ ClaudeAgentOptions,
+ AssistantMessage,
+ TextBlock,
+ ToolUseBlock,
)
from composio import Composio
-# Load environment variables from .env file
load_dotenv()
-# Initialize Composio and create a Tool Router session
-composio = Composio(api_key=os.environ["COMPOSIO_API_KEY"])
-user_id = "user_123" # Your user's unique identifier
+# Initialize Composio (API key from env var COMPOSIO_API_KEY)
+composio = Composio()
+
+# Unique identifier of the user
+user_id = "user_123"
+
+# Create a tool router session for the user
session = composio.create(user_id=user_id)
# Configure Claude with Composio MCP server
options = ClaudeAgentOptions(
system_prompt=(
"You are a helpful assistant with access to external tools. "
- "Always use the available tools to complete user requests instead of just explaining how to do them."
+ "Always use the available tools to complete user requests."
),
mcp_servers={
"composio": {
"type": "http",
"url": session.mcp.url,
- "headers": {"x-api-key": os.environ["COMPOSIO_API_KEY"]},
+ "headers": session.mcp.headers,
}
},
permission_mode="bypassPermissions",
@@ -37,22 +38,35 @@ options = ClaudeAgentOptions(
async def main():
+ print("""
+What task would you like me to help you with?
+I can use tools like Gmail, GitHub, Linear, Notion, and more.
+(Type 'exit' to exit)
+Example tasks:
+ • 'Summarize my emails from today'
+ • 'List all open issues on the composio github repository and create a notion page with the issues'
+""")
+
async with ClaudeSDKClient(options) as client:
+ # Multi-turn conversation with agentic tool calling
while True:
user_input = input("You: ").strip()
- if user_input.lower() in ("quit", "exit"):
+ if user_input.lower() == "exit":
break
- await client.query(user_input)
- async for msg in client.receive_response():
- if isinstance(msg, AssistantMessage):
- for block in msg.content:
- if isinstance(block, ToolUseBlock):
- print(f"[Using tool: {block.name}]")
- elif isinstance(block, TextBlock):
- print(block.text, end="")
- elif isinstance(msg, ResultMessage) and msg.result:
- print(f"\n{msg.result}\n")
+ print("\nClaude: ", end="", flush=True)
+ try:
+ await client.query(user_input)
+ async for msg in client.receive_response():
+ if isinstance(msg, AssistantMessage):
+ for block in msg.content:
+ if isinstance(block, ToolUseBlock):
+ print(f"\n[Using tool: {block.name}]", end="")
+ elif isinstance(block, TextBlock):
+ print(block.text, end="", flush=True)
+ print()
+ except Exception as e:
+ print(f"\n[Error]: {e}")
if __name__ == "__main__":
diff --git a/fern/snippets/tool-router/python/quickstart-mcp-openai.py b/fern/snippets/tool-router/python/quickstart-mcp-openai.py
index 8d9071660..edd7c095e 100644
--- a/fern/snippets/tool-router/python/quickstart-mcp-openai.py
+++ b/fern/snippets/tool-router/python/quickstart-mcp-openai.py
@@ -1,48 +1,56 @@
-import os
from dotenv import load_dotenv
from composio import Composio
from agents import Agent, Runner, HostedMCPTool, SQLiteSession
load_dotenv()
-composio_api_key = os.environ.get("COMPOSIO_API_KEY")
-user_id = "user_123" # Your user's unique identifier
+# Initialize Composio (API key from env var COMPOSIO_API_KEY)
+composio = Composio()
-composio = Composio(api_key=composio_api_key)
-composio_session = composio.create(user_id=user_id)
+# Unique identifier of the user
+user_id = "user_123"
+# Create a Tool Router session for the user
+session = composio.create(user_id=user_id)
+
+# Configure OpenAI agent with Composio MCP server
agent = Agent(
name="Personal Assistant",
instructions="You are a helpful personal assistant. Use Composio tools to take action.",
- model="gpt-5.2",
+ model="gpt-5.2",
tools=[
HostedMCPTool(
tool_config={
"type": "mcp",
"server_label": "composio",
- "server_url": composio_session.mcp.url,
+ "server_url": session.mcp.url,
"require_approval": "never",
- "headers": {"x-api-key": composio_api_key},
+ "headers": session.mcp.headers,
}
)
],
)
-# Create a session for multi-turn conversation memory
-conversation_session = SQLiteSession(user_id)
+# Memory for multi-turn conversation
+memory = SQLiteSession(user_id)
-print("Assistant: What would you like me to do today?\n")
+print("""
+What task would you like me to help you with?
+I can use tools like Gmail, GitHub, Linear, Notion, and more.
+(Type 'exit' to exit)
+Example tasks:
+ • 'Summarize my emails from today'
+ • 'List all open issues on the composio github repository'
+""")
while True:
- user_input = input("> ")
- if user_input == "exit":
+ user_input = input("You: ").strip()
+ if user_input.lower() == "exit":
break
-
- result = Runner.run_sync(
- starting_agent=agent,
- input=user_input,
- session=conversation_session
- )
-
- print(f"Assistant: {result.final_output}\n")
+ print("Assistant: ", end="", flush=True)
+ try:
+ result = Runner.run_sync(starting_agent=agent, input=user_input, session=memory)
+ print(f"{result.final_output}\n")
+ except Exception as e:
+ print(f"\n[Error]: {e}")
diff --git a/fern/snippets/tool-router/python/quickstart-native-openai.py b/fern/snippets/tool-router/python/quickstart-native-openai.py
index 8317d68db..fc7556219 100644
--- a/fern/snippets/tool-router/python/quickstart-native-openai.py
+++ b/fern/snippets/tool-router/python/quickstart-native-openai.py
@@ -1,4 +1,3 @@
-import os
from dotenv import load_dotenv
from composio import Composio
from agents import Agent, Runner, SQLiteSession
@@ -6,35 +5,44 @@ from composio_openai_agents import OpenAIAgentsProvider
load_dotenv()
-composio = Composio(api_key=os.environ.get("COMPOSIO_API_KEY"), provider=OpenAIAgentsProvider())
-session = composio.create(user_id="user_123")
+# Initialize Composio with OpenAI Agents provider (API key from env var COMPOSIO_API_KEY)
+composio = Composio(provider=OpenAIAgentsProvider())
-# Get native tools from Composio
+# Unique identifier of the user
+user_id = "user_123"
+
+# Create a session and get native tools for the user
+session = composio.create(user_id=user_id)
tools = session.tools()
-# Create OpenAI agent with Composio tools
+# Configure OpenAI agent with Composio tools
agent = Agent(
- name="AI Assistant",
- instructions="You are a helpful assistant with access to external tools. Use the available tools to complete user requests.",
+ name="Personal Assistant",
+ instructions="You are a helpful personal assistant. Use Composio tools to take action.",
model="gpt-5.2",
tools=tools,
)
-# Create session for multi-turn conversation
-conversation_session = SQLiteSession("conversation_example")
+# Memory for multi-turn conversation
+memory = SQLiteSession("conversation")
-print("Assistant: What would you like me to do today? Type 'exit' to end the conversation.\n")
+print("""
+What task would you like me to help you with?
+I can use tools like Gmail, GitHub, Linear, Notion, and more.
+(Type 'exit' to exit)
+Example tasks:
+ • 'Summarize my emails from today'
+ • 'List all open issues on the composio github repository'
+""")
while True:
- user_input = input("> ")
+ user_input = input("You: ").strip()
if user_input.lower() == "exit":
break
-
- # Run agent with session to maintain context
- result = Runner.run_sync(
- starting_agent=agent,
- input=user_input,
- session=conversation_session,
- )
-
- print(f"Assistant: {result.final_output}\n")
\ No newline at end of file
+
+ print("Assistant: ", end="", flush=True)
+ try:
+ result = Runner.run_sync(starting_agent=agent, input=user_input, session=memory)
+ print(f"{result.final_output}\n")
+ except Exception as e:
+ print(f"\n[Error]: {e}")
\ No newline at end of file