Quickstart

$
pip install python-dotenv composio claude-agent-sdk

1
import asyncio
2
from dotenv import load_dotenv
3
from claude_agent_sdk.client import ClaudeSDKClient
4
from claude_agent_sdk.types import (
5
    ClaudeAgentOptions,
6
    AssistantMessage,
7
    TextBlock,
8
    ToolUseBlock,
9
)
10
from composio import Composio
11
12
load_dotenv()
13
14
# Initialize Composio (API key from env var COMPOSIO_API_KEY)
15
composio = Composio()
16
17
# Unique identifier of the user
18
user_id = "user_123"
19
20
# Create a tool router session for the user
21
session = composio.create(user_id=user_id)
22
23
# Configure Claude with Composio MCP server
24
options = ClaudeAgentOptions(
25
    system_prompt=(
26
        "You are a helpful assistant with access to external tools. "
27
        "Always use the available tools to complete user requests."
28
    ),
29
    mcp_servers={
30
        "composio": {
31
            "type": "http",
32
            "url": session.mcp.url,
33
            "headers": session.mcp.headers,
34
        }
35
    },
36
    permission_mode="bypassPermissions",
37
)
38
39
40
async def main():
41
    print("""
42
What task would you like me to help you with?
43
I can use tools like Gmail, GitHub, Linear, Notion, and more.
44
(Type 'exit' to exit)
45
Example tasks:
46
  • 'Summarize my emails from today'
47
  • 'List all open issues on the composio github repository and create a notion page with the issues'
48
""")
49
50
    async with ClaudeSDKClient(options) as client:
51
        # Multi-turn conversation with agentic tool calling
52
        while True:
53
            user_input = input("You: ").strip()
54
            if user_input.lower() == "exit":
55
                break
56
57
            print("\nClaude: ", end="", flush=True)
58
            try:
59
                await client.query(user_input)
60
                async for msg in client.receive_response():
61
                    if isinstance(msg, AssistantMessage):
62
                        for block in msg.content:
63
                            if isinstance(block, ToolUseBlock):
64
                                print(f"\n[Using tool: {block.name}]", end="")
65
                            elif isinstance(block, TextBlock):
66
                                print(block.text, end="", flush=True)
67
                print()
68
            except Exception as e:
69
                print(f"\n[Error]: {e}")
70
71
72
if __name__ == "__main__":
73
    asyncio.run(main())

$
pip install python-dotenv composio composio-openai-agents openai-agents

1
from dotenv import load_dotenv
2
from composio import Composio
3
from agents import Agent, Runner, SQLiteSession
4
from composio_openai_agents import OpenAIAgentsProvider
5
6
load_dotenv()
7
8
# Initialize Composio with OpenAI Agents provider (API key from env var COMPOSIO_API_KEY)
9
composio = Composio(provider=OpenAIAgentsProvider())
10
11
# Unique identifier of the user
12
user_id = "user_123"
13
14
# Create a session and get native tools for the user
15
session = composio.create(user_id=user_id)
16
tools = session.tools()
17
18
# Configure OpenAI agent with Composio tools
19
agent = Agent(
20
    name="Personal Assistant",
21
    instructions="You are a helpful personal assistant. Use Composio tools to take action.",
22
    model="gpt-5.2",
23
    tools=tools,
24
)
25
26
# Memory for multi-turn conversation
27
memory = SQLiteSession("conversation")
28
29
print("""
30
What task would you like me to help you with?
31
I can use tools like Gmail, GitHub, Linear, Notion, and more.
32
(Type 'exit' to exit)
33
Example tasks:
34
  • 'Summarize my emails from today'
35
  • 'List all open issues on the composio github repository'
36
""")
37
38
while True:
39
    user_input = input("You: ").strip()
40
    if user_input.lower() == "exit":
41
        break
42
43
    print("Assistant: ", end="", flush=True)
44
    try:
45
        result = Runner.run_sync(starting_agent=agent, input=user_input, session=memory)
46
        print(f"{result.final_output}\n")
47
    except Exception as e:
48
        print(f"\n[Error]: {e}")