Connect 10,000+ Integrations with Composio

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/UnkleFunk/HouseMusicSwarm-/llms.txt

Use this file to discover all available pages before exploring further.

​

Setup

# .env
COMPOSIO_API_KEY=your_key_here
COMPOSIO_USER_ID=your_user_id_here

​

The tool discovery sequence

# Check that Gmail is connected before attempting to send
ManageConnections(toolkits=["GMAIL"])

SearchTools(
    queries=[{"use_case": "send an email with an attachment"}],
    session={"generate_id": True},
)

FindTools(
    tool_names=["GMAIL_SEND_EMAIL"],
    include_args=True,
)

ExecuteTool(
    tool_name="GMAIL_SEND_EMAIL",
    arguments={
        "to": ["user@example.com"],
        "subject": "Hello",
        "body": "Hi from OpenSwarm",
    },
    return_fields=["successful", "message_id"],
)

​

Programmatic tool calling

# Fetch available Gmail tools
tools = composio.tools.get(
    user_id=user_id,
    toolkits=["GMAIL"],
    limit=5,
)

# Execute a tool call directly
result = composio.tools.execute(
    tool_name="GMAIL_SEND_EMAIL",
    user_id=user_id,
    arguments={
        "to": ["user@example.com"],
        "subject": "Hello",
        "body": "Hi from agent",
    },
    dangerously_skip_version_check=True,
)
print(result)

​

Supported toolkit families

​

Best practices

• Save intermediate results to variables — if a tool returns a list of records you’ll reference later, store it rather than calling the tool again. Repeated API calls slow down the workflow and consume rate limit quota.
• Explore the returned data structure before extracting fields — Composio responses vary by toolkit. Run a FindTools or an initial ExecuteTool call without return_fields first, inspect the shape of the response, then add return_fields to subsequent calls to extract only what you need.
• Format outputs for readability — agents should return clean, human-readable summaries rather than raw JSON blobs. Include only the fields that are relevant to the current task; strip internal metadata the user doesn’t need.
• Use SearchTools before FindTools when the exact tool name is unknown — attempting FindTools with a guess at a tool name wastes a round-trip if the name is wrong. The search step is fast and returns exact names you can pass directly to FindTools.
• Prefer ExecuteTool over ProgrammaticToolCalling — ExecuteTool handles auth context, error formatting, and field extraction automatically. Only drop down to ProgrammaticToolCalling (i.e., direct composio.tools.execute(...) calls) when you need conditional logic or data transformation between multiple tool calls.