SDK Reference

Python SDK Reference

Markdown

Python SDK Reference

Complete API reference for the composio Python package.

Installation

pip install composio

Or with uv:

uv add composio

Classes

ClassDescription
ComposioComposio SDK for Python.
ToolsTools class definition This class is used to manage tools in the Composio SDK. ...
ToolkitsToolkits are a collectiono of tools that can be used to perform various tasks. T...
TriggersTriggers (instance) class
ConnectedAccountsManage connected accounts. This class is used to manage connected accounts in t...
AuthConfigsManage authentication configurations.
MCPMCP (Model Control Protocol) class. Provides enhanced MCP server operations Thi...

Quick Start

from composio import Composio

composio = Composio(api_key="your-api-key")

# Get tools for a user
tools = composio.tools.get("user-123", toolkits=["github"])

# Execute a tool
result = composio.tools.execute(
    "GITHUB_GET_REPOS",
    arguments={"owner": "composio"},
    user_id="user-123"
)

Decorators

before_execute

View source

@before_execute(modifier: BeforeExecute | None = ..., tools: List[str | None] = ..., toolkits: List[str | None] = ...)
def my_modifier(...):
    ...

after_execute

View source

@after_execute(modifier: AfterExecute | None = ..., tools: List[str | None] = ..., toolkits: List[str | None] = ...)
def my_modifier(...):
    ...

schema_modifier

View source

@schema_modifier(modifier: SchemaModifier | None = ..., tools: List[str | None] = ..., toolkits: List[str | None] = ...)
def my_modifier(...):
    ...