@devries-cameron20 / composio Mirror · read-only
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 04:45 UTC

next
md 64 lines 2.09 KB
Rendered Raw
1 # composio-claude-agent-sdk
2
3 Adapts Composio tools to the [Claude Agent SDK](https://platform.claude.com/docs/en/agent-sdk/python), exposing them to Claude through an in-process MCP server.
4
5 ## Installation
6
7 ```bash
8 pip install composio composio-claude-agent-sdk claude-agent-sdk
9 ```
10
11 The Claude Agent SDK also requires the Claude Code CLI: `npm install -g @anthropic-ai/claude-code`.
12
13 Set `COMPOSIO_API_KEY` (from the [dashboard](https://dashboard.composio.dev/settings)) and `ANTHROPIC_API_KEY` in your environment.
14
15 ## Quickstart
16
17 ```python
18 import asyncio
19
20 from composio import Composio
21 from composio_claude_agent_sdk import ClaudeAgentSDKProvider
22 from claude_agent_sdk import (
23 AssistantMessage,
24 ClaudeAgentOptions,
25 TextBlock,
26 create_sdk_mcp_server,
27 query,
28 )
29
30 composio = Composio(provider=ClaudeAgentSDKProvider())
31
32 # Each session is scoped to one of your users
33 session = composio.create(user_id="user_123")
34 tools = session.tools()
35
36 server = create_sdk_mcp_server(name="composio", version="1.0.0", tools=tools)
37
38
39 async def main():
40 options = ClaudeAgentOptions(
41 system_prompt="You are a helpful assistant. Use tools to complete tasks.",
42 permission_mode="bypassPermissions",
43 mcp_servers={"composio": server},
44 )
45 async for message in query(prompt="Summarize my emails from today", options=options):
46 if isinstance(message, AssistantMessage):
47 for block in message.content:
48 if isinstance(block, TextBlock):
49 print(block.text)
50
51
52 asyncio.run(main())
53 ```
54
55 For multi-turn use, store `session.session_id` and reuse it with `composio.use(session_id)` instead of calling `create()` again.
56
57 ## How tools are exposed
58
59 `session.tools()` returns `SdkMcpTool` objects that plug straight into `create_sdk_mcp_server`. The provider also ships `composio.provider.create_mcp_server(tools)` if you prefer a preconfigured server (name `composio`, customizable via `ClaudeAgentSDKProvider(server_name=..., server_version=...)`).
60
61 ## Links
62
63 - [Quickstart](https://docs.composio.dev/docs/quickstart)
64 - [Composio documentation](https://docs.composio.dev)