Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs: auto-generate Python SDK reference
jkomyno committed
Feb 9, 2026 at 10:53 UTC
2319d725b3dfffac349fe404783bb79694afed29
4 files changed
+12
-8
docs/content/reference/sdk-reference/python/composio.mdx
+2
-2
@@ -1,6 +1,6 @@
1
---
2
title: Composio
3
-description: Composio SDK for Python.
3
+description: "Composio SDK for Python. Generic parameters: TTool: The individual tool type returned by the provider (e.g., ChatCompletionToolParam for OpenAI). ..."
4
---
5
6
## Properties
@@ -14,4 +14,4 @@ description: Composio SDK for Python.
14
| [`connected_accounts`](/reference/sdk-reference/python/connected-accounts) | `ConnectedAccounts` |
15
| [`mcp`](/reference/sdk-reference/python/mcp) | `MCP` |
16
17
-[View source](https://github.com/composiohq/composio/blob/next/python/composio/sdk.py#L53)
17
+[View source](https://github.com/composiohq/composio/blob/next/python/composio/sdk.py#L46)
docs/content/reference/sdk-reference/python/index.mdx
+1
-1
@@ -23,7 +23,7 @@ uv add composio
23
24
| Class | Description |
25
|-------|-------------|
26
-| [`Composio`](/reference/sdk-reference/python/composio) | Composio SDK for Python. |
26
+| [`Composio`](/reference/sdk-reference/python/composio) | Composio SDK for Python. Generic parameters: TTool: The individual tool type re... |
27
| [`Tools`](/reference/sdk-reference/python/tools) | Tools class definition This class is used to manage tools in the Composio SDK. ... |
28
| [`Toolkits`](/reference/sdk-reference/python/toolkits) | Toolkits are a collectiono of tools that can be used to perform various tasks. T... |
29
| [`Triggers`](/reference/sdk-reference/python/triggers) | Triggers (instance) class |
docs/content/reference/sdk-reference/python/tools.mdx
+8
-4
@@ -1,6 +1,6 @@
1
---
2
title: Tools
3
-description: Tools class definition This class is used to manage tools in the Composio SDK. It provides methods to list, get, and execute tools.
3
+description: Tools class definition This class is used to manage tools in the Composio SDK. It provides methods to list, get, and execute tools. Generic Param...
4
---
5
6
## Methods
@@ -101,10 +101,10 @@ def get_raw_tool_router_meta_tools(session_id: str, modifiers: 'Modifiers' | Non
101
102
### get()
103
104
-Get a tool or list of tools based on the provided arguments.
104
+Get a tool or list of tools based on the provided arguments. The return type is automatically inferred based on the provider's generic parameters. For example: - OpenAIProvider -> list[ChatCompletionToolParam] - AnthropicProvider -> list[ToolParam] - CustomProvider[MyTool, list[MyTool]] -> list[MyTool]
105
106
```python
107
-def get(user_id: str, slug: str | None = ..., tools: list[str | None] = ..., search: str | None = ..., toolkits: list[str | None] = ..., scopes: List[str | None] = ..., modifiers: Modifiers | None = ..., limit: int | None = ...)
107
+def get(user_id: str, slug: str | None = ..., tools: list[str | None] = ..., search: str | None = ..., toolkits: list[str | None] = ..., scopes: List[str | None] = ..., modifiers: Modifiers | None = ..., limit: int | None = ...) -> TToolCollection
108
```
109
110
**Parameters**
@@ -120,6 +120,10 @@ def get(user_id: str, slug: str | None = ..., tools: list[str | None] = ..., sea
120
| `modifiers?` | `Modifiers \| None` |
121
| `limit?` | `int \| None` |
122
123
+**Returns**
124
+
125
+`TToolCollection` — Provider-specific tool collection (TToolCollection).
126
+
127
---
128
129
### execute()
@@ -176,4 +180,4 @@ def proxy(endpoint: str, method: Literal['GET', 'POST', 'PUT', 'DELETE', 'PATCH'
180
181
---
182
179
-[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tools.py#L48)
183
+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tools.py#L45)
docs/content/reference/sdk-reference/python/triggers.mdx
+1
-1
@@ -156,4 +156,4 @@ def verify_webhook(id: str, payload: str, secret: str, signature: str, timestamp
156
157
---
158
159
-[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/triggers.py#L689)
159
+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/triggers.py#L701)