composio-claude-agent-sdk

Adapts Composio tools to the Claude Agent SDK, exposing them to Claude through an in-process MCP server.

Installation

pip install composio composio-claude-agent-sdk claude-agent-sdk

The Claude Agent SDK also requires the Claude Code CLI: npm install -g @anthropic-ai/claude-code.

Set COMPOSIO_API_KEY (from the dashboard) and ANTHROPIC_API_KEY in your environment.

Quickstart

import asyncio

from composio import Composio
from composio_claude_agent_sdk import ClaudeAgentSDKProvider
from claude_agent_sdk import (
    AssistantMessage,
    ClaudeAgentOptions,
    TextBlock,
    create_sdk_mcp_server,
    query,
)

composio = Composio(provider=ClaudeAgentSDKProvider())

# Each session is scoped to one of your users
session = composio.create(user_id="user_123")
tools = session.tools()

server = create_sdk_mcp_server(name="composio", version="1.0.0", tools=tools)


async def main():
    options = ClaudeAgentOptions(
        system_prompt="You are a helpful assistant. Use tools to complete tasks.",
        permission_mode="bypassPermissions",
        mcp_servers={"composio": server},
    )
    async for message in query(prompt="Summarize my emails from today", options=options):
        if isinstance(message, AssistantMessage):
            for block in message.content:
                if isinstance(block, TextBlock):
                    print(block.text)


asyncio.run(main())

For multi-turn use, store session.session_id and reuse it with composio.use(session_id) instead of calling create() again.

How tools are exposed

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=...)).

Release files for composio-claude-agent-sdk 0.23.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for composio-claude-agent-sdk 0.23.0
File	Size	Uploaded
composio_claude_agent_sdk-0.23.0.tar.gz	6.1 kB	Sep 23, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for composio-claude-agent-sdk 0.23.0
File	Interpreter	ABI	Platform	Reset
composio_claude_agent_sdk-0.23.0-py3-none-any.whl 6.9 kB Sep 23, 2026	Python 3	none	any	Details

Total release size: 13.0 kB

Release files / composio_claude_agent_sdk-0.23.0.tar.gz

Download URL	composio_claude_agent_sdk-0.23.0.tar.gz
Size	6.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`fdf5b12442e0ef8eca0f7ca5db0780697f7fa6f7159150e16fe30822b78ef9d7`
BLAKE2b-256 checksum How to use checksums	`392b31de80ddabacd93c2502545ecdd43526b3d4dd6bd871d36151c5c8ec3ca1`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / composio_claude_agent_sdk-0.23.0-py3-none-any.whl

Download URL	composio_claude_agent_sdk-0.23.0-py3-none-any.whl
Size	6.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`440efff2c7b4a49cf86320e91269e0b158264105510b706111259d090964412b`
BLAKE2b-256 checksum How to use checksums	`c42b9c526e25bd8ed8238e49be5366bc84d4ab5c985f5aba2deb6b6c2d33555e`
Upload date	Sep 23, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`