@devries-cameron20 / composio-1 / commits / 007c6639a
Fork 0

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>