Quickstart

$
pip install composio claude-agent-sdk

1
import asyncio
2
import os
3
from dotenv import load_dotenv
4
from claude_agent_sdk.client import ClaudeSDKClient
5
from claude_agent_sdk.types import (
6
    ClaudeAgentOptions, 
7
    ResultMessage, 
8
    AssistantMessage, 
9
    TextBlock, 
10
    ToolUseBlock
11
)
12
from composio import Composio
13
14
# Load environment variables from .env file
15
load_dotenv()
16
17
# Initialize Composio and create a Tool Router session
18
composio = Composio(api_key=os.environ["COMPOSIO_API_KEY"])
19
user_id = "user_123"  # Your user's unique identifier
20
session = composio.create(user_id=user_id)
21
22
# Configure Claude with Composio MCP server
23
options = ClaudeAgentOptions(
24
    system_prompt=(
25
        "You are a helpful assistant with access to external tools. "
26
        "Always use the available tools to complete user requests instead of just explaining how to do them."
27
    ),
28
    mcp_servers={
29
        "composio": {
30
            "type": "http",
31
            "url": session.mcp.url,
32
            "headers": {"x-api-key": os.environ["COMPOSIO_API_KEY"]},
33
        }
34
    },
35
    permission_mode="bypassPermissions",
36
)
37
38
39
async def main():
40
    async with ClaudeSDKClient(options) as client:
41
        while True:
42
            user_input = input("You: ").strip()
43
            if user_input.lower() in ("quit", "exit"):
44
                break
45
46
            await client.query(user_input)
47
            async for msg in client.receive_response():
48
                if isinstance(msg, AssistantMessage):
49
                    for block in msg.content:
50
                        if isinstance(block, ToolUseBlock):
51
                            print(f"[Using tool: {block.name}]")
52
                        elif isinstance(block, TextBlock):
53
                            print(block.text, end="")
54
                elif isinstance(msg, ResultMessage) and msg.result:
55
                    print(f"\n{msg.result}\n")
56
57
58
if __name__ == "__main__":
59
    asyncio.run(main())

$
pip install composio composio-openai-agents openai-agents

1
import os
2
from dotenv import load_dotenv
3
from composio import Composio
4
from agents import Agent, Runner, SQLiteSession
5
from composio_openai_agents import OpenAIAgentsProvider
6
7
load_dotenv()
8
9
composio = Composio(api_key=os.environ.get("COMPOSIO_API_KEY"), provider=OpenAIAgentsProvider())
10
session = composio.create(user_id="user_123")
11
12
# Get native tools from Composio
13
tools = session.tools()
14
15
# Create OpenAI agent with Composio tools
16
agent = Agent(
17
    name="AI Assistant",
18
    instructions="You are a helpful assistant with access to external tools. Use the available tools to complete user requests.",
19
    model="gpt-5.2",
20
    tools=tools,
21
)
22
23
# Create session for multi-turn conversation
24
conversation_session = SQLiteSession("conversation_example")
25
26
print("Assistant: What would you like me to do today? Type 'exit' to end the conversation.\n")
27
28
while True:
29
    user_input = input("> ")
30
    if user_input.lower() == "exit":
31
        break
32
    
33
    # Run agent with session to maintain context
34
    result = Runner.run_sync(
35
        starting_agent=agent,
36
        input=user_input,
37
        session=conversation_session,
38
    )
39
    
40
    print(f"Assistant: {result.final_output}\n")