Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
quickstart p0
Sushmithamallesh committed
Nov 27, 2025 at 06:59 UTC
007c6639afa15302a167cb411ea94e7cbcb82681
1 file changed
+28
-13
fern/pages/src/tool-router/quickstart.mdx
+28
-13
@@ -22,7 +22,8 @@ pip install composio openai-agents composio-openai-agents
22
Sessions are ephemeral, user-scoped and manage connections and tools for that user. See [Session Management](/docs/user-management) and [Configuring Toolkits](/tool-router/configuring-toolkits).
23
24
<Info>
25
-Replace `your-api-key` with your Composio API key from the [developer dashboard](https://platform.composio.dev/?next_page=/settings). Replace `user_123` with the ID of the user in your system.
25
+`your-api-key`: Your Composio API key from the [dashboard](https://platform.composio.dev/?next_page=/settings).
26
+`user_123`: The [ID of the user](/docs/user-management) in your system.
27
</Info>
28
```python
29
from composio import Composio
@@ -32,6 +33,8 @@ composio = Composio(
33
api_key="your-api-key",
34
provider=OpenAIAgentsProvider()
35
)
36
+
37
+# Create a session for a user
38
session = composio.create(user_id="user_123")
39
```
40
</Step>
@@ -42,8 +45,8 @@ When the agent needs authentication, it will prompt the user to connect. To pre-
45
from agents import Agent, Runner
46
47
agent = Agent(
45
- name="Assistant",
46
- instructions="You are a helpful assistant.",
48
+ name="Personal Assistant",
49
+ instructions="You are a helpful personal assistant.",
50
tools=session.tools()
51
)
52
@@ -73,7 +76,8 @@ npm install @composio/core @composio/openai-agents @openai/agents
76
Sessions are ephemeral, user-scoped and manage connections and tools for that user. See [Session Management](/docs/user-management) and [Configuring Toolkits](/tool-router/configuring-toolkits).
77
78
<Info>
76
-Replace `your-api-key` with your Composio API key from the [developer dashboard](https://platform.composio.dev/?next_page=/settings). Replace `user_123` with the ID of the user in your system.
79
+`your-api-key`: Your Composio API key from the [dashboard](https://platform.composio.dev/?next_page=/settings).
80
+`user_123`: The [ID of the user](/docs/user-management) in your system.
81
</Info>
82
```typescript
83
import { Composio } from "@composio/core";
@@ -83,6 +87,8 @@ const composio = new Composio({
87
apiKey: "your-api-key",
88
provider: new OpenAIAgentsProvider(),
89
});
90
+
91
+// Create a session for a user
92
const { tools } = await composio.create("user_123");
93
```
94
</Step>
@@ -93,8 +99,8 @@ When the agent needs authentication, it will prompt the user to connect. To pre-
99
import { Agent, run } from "@openai/agents";
100
101
const agent = new Agent({
96
- name: "Assistant",
97
- instructions: "You are a helpful assistant.",
102
+ name: "Personal Assistant",
103
+ instructions: "You are a helpful personal assistant.",
104
tools: await tools(),
105
});
106
@@ -124,7 +130,8 @@ pip install composio anthropic-agents composio-anthropic
130
Sessions are ephemeral, user-scoped and manage connections and tools for that user. See [Session Management](/docs/user-management) and [Configuring Toolkits](/tool-router/configuring-toolkits).
131
132
<Info>
127
-Replace `your-api-key` with your Composio API key from the [developer dashboard](https://platform.composio.dev/?next_page=/settings). Replace `user_123` with the ID of the user in your system.
133
+`your-api-key`: Your Composio API key from the [dashboard](https://platform.composio.dev/?next_page=/settings).
134
+`user_123`: The [ID of the user](/docs/user-management) in your system.
135
</Info>
136
```python
137
from composio import Composio
@@ -134,6 +141,8 @@ composio = Composio(
141
api_key="your-api-key",
142
provider=AnthropicProvider()
143
)
144
+
145
+# Create a session for a user
146
session = composio.create(user_id="user_123")
147
```
148
</Step>
@@ -144,8 +153,8 @@ When the agent needs authentication, it will prompt the user to connect. To pre-
153
from anthropic_agents import Agent, run
154
155
agent = Agent(
147
- name="Assistant",
148
- instructions="You are a helpful assistant.",
156
+ name="Personal Assistant",
157
+ instructions="You are a helpful personal assistant.",
158
mcp_servers=[session.mcp.url]
159
)
160
@@ -175,7 +184,8 @@ npm install @composio/core @composio/anthropic @anthropic-ai/agent
184
Sessions are ephemeral, user-scoped and manage connections and tools for that user. See [Session Management](/docs/user-management) and [Configuring Toolkits](/tool-router/configuring-toolkits).
185
186
<Info>
178
-Replace `your-api-key` with your Composio API key from the [developer dashboard](https://platform.composio.dev/?next_page=/settings). Replace `user_123` with the ID of the user in your system.
187
+`your-api-key`: Your Composio API key from the [dashboard](https://platform.composio.dev/?next_page=/settings).
188
+`user_123`: The [ID of the user](/docs/user-management) in your system.
189
</Info>
190
```typescript
191
import { Composio } from "@composio/core";
@@ -185,6 +195,8 @@ const composio = new Composio({
195
apiKey: "your-api-key",
196
provider: new AnthropicProvider(),
197
});
198
+
199
+// Create a session for a user
200
const { mcp } = await composio.create("user_123");
201
```
202
</Step>
@@ -195,8 +207,8 @@ When the agent needs authentication, it will prompt the user to connect. To pre-
207
import { Agent, run } from "@anthropic-ai/agent";
208
209
const agent = new Agent({
198
- name: "Assistant",
199
- instructions: "You are a helpful assistant.",
210
+ name: "Personal Assistant",
211
+ instructions: "You are a helpful personal assistant.",
212
mcpServers: [mcp.url],
213
});
214
@@ -226,7 +238,8 @@ npm install @composio/core @composio/vercel ai @ai-sdk/openai
238
Sessions are ephemeral, user-scoped and manage connections and tools for that user. See [Session Management](/docs/user-management) and [Configuring Toolkits](/tool-router/configuring-toolkits).
239
240
<Info>
229
-Replace `your-api-key` with your Composio API key from the [developer dashboard](https://platform.composio.dev/?next_page=/settings). Replace `user_123` with the ID of the user in your system.
241
+`your-api-key`: Your Composio API key from the [dashboard](https://platform.composio.dev/?next_page=/settings).
242
+`user_123`: The [ID of the user](/docs/user-management) in your system.
243
</Info>
244
```typescript
245
import { Composio } from "@composio/core";
@@ -236,6 +249,8 @@ const composio = new Composio({
249
apiKey: "your-api-key",
250
provider: new VercelProvider(),
251
});
252
+
253
+// Create a session for a user
254
const { tools } = await composio.create("user_123");
255
```
256
</Step>