Using with MCP clients

$
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 or pass explicitly)
15
composio = Composio()
16
17
# Unique identifier of the user
18
user_id = "user_123"
19
# Create a tool router session for the user
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."
27
    ),
28
    mcp_servers={
29
        "composio": {
30
            "type": "http",
31
            "url": session.mcp.url,
32
            "headers": session.mcp.headers,  # Authentication headers for the Composio MCP server
33
        }
34
    },
35
    permission_mode="bypassPermissions",  # Auto-approve tools (demo only)
36
)
37
38
async def main():
39
    print("""
40
What task would you like me to help you with?
41
I can use tools like Gmail, GitHub, Linear, Notion, and more.
42
(Type 'exit' to exit)
43
Example tasks:
44
  • 'Summarize my emails from today'
45
  • 'List all open issues on the composio github repository and create a notion page with the issues'
46
""")
47
48
    async with ClaudeSDKClient(options) as client:
49
        # Multi-turn conversation with agentic tool calling
50
        while True:
51
            user_input = input("\nYou: ").strip()
52
            if user_input.lower() == "exit":
53
                break
54
            
55
            print("\nClaude: ", end="", flush=True)
56
            try:
57
                await client.query(user_input)
58
                async for msg in client.receive_response():
59
                    if isinstance(msg, AssistantMessage):
60
                        for block in msg.content:
61
                            if isinstance(block, ToolUseBlock):
62
                                print(f"\n[Using tool: {block.name}]", end="")
63
                            elif isinstance(block, TextBlock):
64
                                print(block.text, end="", flush=True)
65
            except Exception as e:
66
                print(f"\n[Error]: {e}")
67
68
if __name__ == "__main__":
69
    asyncio.run(main())

$
pip install python-dotenv composio openai-agents

1
from dotenv import load_dotenv
2
from composio import Composio
3
from agents import Agent, Runner, HostedMCPTool
4
5
load_dotenv()
6
7
# Initialize Composio (API key from env var COMPOSIO_API_KEY)
8
composio = Composio()
9
# Unique identifier of the user
10
user_id = "user_123"
11
12
# Create a Tool Router session for the user
13
session = composio.create(user_id=user_id)
14
15
# Configure OpenAI agent with Composio MCP server
16
agent = Agent(
17
    name="Personal Assistant",
18
    instructions="You are a helpful personal assistant. Use Composio tools to take action.",
19
    model="gpt-5.2",
20
    tools=[
21
        HostedMCPTool(
22
            tool_config={
23
                "type": "mcp",
24
                "server_label": "composio",
25
                "server_url": session.mcp.url,
26
                "require_approval": "never",
27
                "headers": session.mcp.headers,
28
            }
29
        )
30
    ],
31
)
32
33
# Execute the task
34
print("Fetching GitHub issues from the Composio repository @ComposioHQ/composio...\n")
35
try:
36
    result = Runner.run_sync(
37
        starting_agent=agent,
38
        input="Fetch all the open GitHub issues on the composio repository and group them by bugs/features/docs.",
39
    )
40
    print(result.final_output)
41
except Exception as e:
42
    print(f"[Error]: {e}")
43
44
print("\n\n---")
45
print("Tip: If prompted to authenticate, complete the auth flow and run again.")