> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Python SDK Reference

> API reference for the Composio Python SDK

Complete API reference for the `composio` Python package.

## Installation

```bash uv theme={null}
uv add composio
```

```bash pip theme={null}
pip install composio
```

## Classes

| Class | Description |
| - | - |
| [`Composio`](https://composio-preview.mintlify.site/reference/sdk-reference/python/composio) | Composio SDK for Python.  Generic parameters: TTool: The individual tool type re... |
| [`Tools`](https://composio-preview.mintlify.site/reference/sdk-reference/python/tools) | Tools class definition  This class is used to manage tools in the Composio SDK. ... |
| [`Toolkits`](https://composio-preview.mintlify.site/reference/sdk-reference/python/toolkits) | Toolkits are a collectiono of tools that can be used to perform various tasks. T... |
| [`Triggers`](https://composio-preview.mintlify.site/reference/sdk-reference/python/triggers) | Triggers (instance) class |
| [`ConnectedAccounts`](https://composio-preview.mintlify.site/reference/sdk-reference/python/connected-accounts) | Manage connected accounts.  This class is used to manage connected accounts in t... |
| [`AuthConfigs`](https://composio-preview.mintlify.site/reference/sdk-reference/python/auth-configs) | Manage authentication configurations. |
| [`MCP`](https://composio-preview.mintlify.site/reference/sdk-reference/python/mcp) | MCP (Model Control Protocol) class. Provides enhanced MCP server operations  Thi... |
| [`Session`](https://composio-preview.mintlify.site/reference/sdk-reference/python/session) | A Composio session — the object returned by `composio.create(...)` / \`composio.u... |

## Quick Start

```python theme={null}
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](https://github.com/composiohq/composio/blob/next/python/composio/core/models/_modifiers.py#L278)

```python theme={null}
@before_execute(modifier: BeforeExecute | None = ..., tools: List[str | None] = ..., toolkits: List[str | None] = ...)
def my_modifier(...):
    ...
```

### after\_execute

[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/_modifiers.py#L239)

```python theme={null}
@after_execute(modifier: AfterExecute | None = ..., tools: List[str | None] = ..., toolkits: List[str | None] = ...)
def my_modifier(...):
    ...
```

### before\_file\_upload

Build a `Modifier` for the file-upload hook (same scoping pattern as `before_execute`).  Your callable may take **either**:  - a single `context` argument (`BeforeFileUploadContext`) — the preferred form, exposes `context["source"]` (`"path"` or `"url"`), or - three positional arguments `(path, tool, toolkit)` — legacy form, kept for back-compat.  Return a new path/URL string to substitute, or `False` to abort the upload (raises `FileUploadAbortedError`).  Pass the returned `Modifier` in `modifiers=[...]` on `composio.core.models.tools.Tools.execute` or `tools.get`. Multiple such modifiers are composed in list order.

[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/_modifiers.py#L317)

```python theme={null}
@before_file_upload(modifier: BeforeFileUploadLike | None = ..., tools: List[str | None] = ..., toolkits: List[str | None] = ...)
def my_modifier(...):
    ...
```

### schema\_modifier

[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/_modifiers.py#L375)

```python theme={null}
@schema_modifier(modifier: SchemaModifier | None = ..., tools: List[str | None] = ..., toolkits: List[str | None] = ...)
def my_modifier(...):
    ...
```
