composio-anthropic
Adapts Composio tools to the Claude Messages API tool format and executes the tool calls Claude returns.
Installation
pip install composio composio-anthropic anthropic
Set COMPOSIO_API_KEY (create one at https://dashboard.composio.dev/settings) and ANTHROPIC_API_KEY in your environment.
Quickstart
AnthropicProvider is non-agentic: Claude returns tool_use blocks, handle_tool_calls executes them, and you send the results back as tool_result blocks.
import json
import anthropic
from composio import Composio
from composio_anthropic import AnthropicProvider
composio = Composio(provider=AnthropicProvider())
client = anthropic.Anthropic()
# Create a session for your user
session = composio.create(user_id="user_123")
tools = session.tools()
messages = [
{"role": "user", "content": "Send an email to john@example.com with the subject 'Hello' and body 'Hello from Composio!'"}
]
response = client.messages.create(
model="claude-opus-4-6",
max_tokens=4096,
tools=tools,
messages=messages,
)
# Agentic loop: keep executing tool calls until the model responds with text
while response.stop_reason == "tool_use":
tool_use_blocks = [block for block in response.content if block.type == "tool_use"]
results = composio.provider.handle_tool_calls(session=session, response=response)
messages.append({"role": "assistant", "content": response.content})
messages.append({
"role": "user",
"content": [
{"type": "tool_result", "tool_use_id": tool_use_blocks[i].id, "content": json.dumps(result)}
for i, result in enumerate(results)
]
})
response = client.messages.create(
model="claude-opus-4-6",
max_tokens=4096,
tools=tools,
messages=messages,
)
# Print final response
for block in response.content:
if block.type == "text":
print(block.text)
handle_tool_calls extracts every tool_use block from the response, executes the matching Composio tools through the supplied session, and returns the raw results in order. Pass user_id instead for tools fetched with tools.get(). Claude occasionally emits tool input as a JSON string instead of an object; the provider normalizes this before execution.
Building on the Claude Agent SDK instead of the Messages API? Use composio-claude-agent-sdk.
Links
- Anthropic provider docs: https://docs.composio.dev/docs/providers/anthropic
- Composio docs: https://docs.composio.dev
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file composio_anthropic-0.20.0.tar.gz.
File metadata
- Download URL: composio_anthropic-0.20.0.tar.gz
- Upload date:
- Size: 4.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4005d742a3f27b4d2b04ac3df9bd5e3122cfe69acf4be21600188649b62e1f8c
|
|
| MD5 |
d686d6ac643ca5bd7a482dbfecdab48c
|
|
| BLAKE2b-256 |
8b0dce3df81e6e15a2bc5e51b87955e9e18c960743dda8961bdadc7713f9d0a6
|
File details
Details for the file composio_anthropic-0.20.0-py3-none-any.whl.
File metadata
- Download URL: composio_anthropic-0.20.0-py3-none-any.whl
- Upload date:
- Size: 4.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a5e277d21961f882db900db66e90fcba313b130923a2d099a20a9bed3d6f24b2
|
|
| MD5 |
12efa180ac2adc50b6b160d02bd5d115
|
|
| BLAKE2b-256 |
3e9e659032b77a558c7af1627bf31ba3dfeaa72d27532e6f4dcb99430fdcb7e0
|
