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: Python snippets fix tool router
Sushmithamallesh88229dbd6ef2
diff --git a/fern/pages/src/tool-router/quickstart.mdx b/fern/pages/src/tool-router/quickstart.mdxindex 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/agentsdiff --git a/fern/pages/src/tool-router/using-as-a-native-tool.mdx b/fern/pages/src/tool-router/using-as-a-native-tool.mdxindex 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/agentsdiff --git a/fern/pages/src/tool-router/using-with-mcp-clients.mdx b/fern/pages/src/tool-router/using-with-mcp-clients.mdxindex 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/agentsCreate 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/mcpUse 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 filediff --git a/fern/snippets/tool-router/python/mcp-claude.py b/fern/snippets/tool-router/python/mcp-claude.pyindex 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 osfrom dotenv import load_dotenvfrom 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 Composioload_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 usersession = composio.create(user_id=user_id)# Configure Claude with Composio MCP serveroptions = 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 filediff --git a/fern/snippets/tool-router/python/mcp-openai.py b/fern/snippets/tool-router/python/mcp-openai.pyindex 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 osfrom dotenv import load_dotenvfrom composio import Composio-from agents import Agent, Runner, HostedMCPTool, ModelSettings+from agents import Agent, Runner, HostedMCPTool-# Load environment variables from .env fileload_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 usersession = composio.create(user_id=user_id)# Configure OpenAI agent with Composio MCP serveragent = 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 filediff --git a/fern/snippets/tool-router/python/native-tools-openai.py b/fern/snippets/tool-router/python/native-tools-openai.pyindex 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 osfrom dotenv import load_dotenvfrom composio import Composiofrom agents import Agent, Runner, SQLiteSessionfrom composio_openai_agents import OpenAIAgentsProvider-# Load environment variables from .env fileload_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 toolsagent = 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 filediff --git a/fern/snippets/tool-router/python/quickstart-mcp-claude.py b/fern/snippets/tool-router/python/quickstart-mcp-claude.pyindex 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 osfrom dotenv import load_dotenvfrom claude_agent_sdk.client import ClaudeSDKClientfrom claude_agent_sdk.types import (- ClaudeAgentOptions,- ResultMessage,- AssistantMessage,- TextBlock,- ToolUseBlock+ ClaudeAgentOptions,+ AssistantMessage,+ TextBlock,+ ToolUseBlock,)from composio import Composio-# Load environment variables from .env fileload_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 usersession = composio.create(user_id=user_id)# Configure Claude with Composio MCP serveroptions = 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 callingwhile 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.pyindex 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 osfrom dotenv import load_dotenvfrom composio import Composiofrom agents import Agent, Runner, HostedMCPTool, SQLiteSessionload_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 serveragent = 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.pyindex 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 osfrom dotenv import load_dotenvfrom composio import Composiofrom agents import Agent, Runner, SQLiteSession@@ -6,35 +5,44 @@ from composio_openai_agents import OpenAIAgentsProviderload_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 toolsagent = 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