Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
session fixes
Sushmithamallesh committed
Dec 3, 2025 at 20:14 UTC
af242d96f9465ba173828283e712dca4a0a9a926
14 files changed
+216
-119
fern/pages/src/tool-router/manually-authenticating-users.mdx
+6
-9
@@ -15,14 +15,13 @@ Disable the `COMPOSIO_MANAGE_CONNECTIONS` meta-tool so the agent doesn't prompt
15
16
<CodeGroup>
17
```python
18
-session = await composio.create_session(
18
+session = await composio.create(
19
user="pg-user-550e8400-e29b-41d4",
20
manage_connections=False,
21
)
22
```
23
```typescript
24
-const session = await composio.createSession({
25
- user: "pg-user-550e8400-e29b-41d4",
24
+const session = await composio.create("pg-user-550e8400-e29b-41d4", {
25
manageConnections: false,
26
});
27
```
@@ -134,7 +133,7 @@ A common pattern is to verify all required connections before starting the agent
133
```python
134
required_toolkits = ["gmail", "googlecalendar", "linear", "slack"]
135
137
-session = await composio.create_session(
136
+session = await composio.create(
137
user=user_id,
138
manage_connections=False,
139
)
@@ -163,8 +162,7 @@ tools = await session.tools()
162
```typescript
163
const requiredToolkits = ["gmail", "googlecalendar", "linear", "slack"];
164
166
-const session = await composio.createSession({
167
- user: userId,
165
+const session = await composio.create(userId, {
166
manageConnections: false,
167
});
168
@@ -198,7 +196,7 @@ To use a specific account, pass it in the session config:
196
197
<CodeGroup>
198
```python
201
-session = await composio.create_session(
199
+session = await composio.create(
200
user=user_id,
201
connected_accounts={
202
"gmail": "ca_specific_account_id",
@@ -206,8 +204,7 @@ session = await composio.create_session(
204
)
205
```
206
```typescript
209
-const session = await composio.createSession({
210
- user: userId,
207
+const session = await composio.create(userId, {
208
connectedAccounts: {
209
gmail: "ca_specific_account_id",
210
},
fern/pages/src/tool-router/using-in-chat-authentication.mdx
+6
-10
@@ -19,14 +19,12 @@ In-chat auth is enabled by default. The `COMPOSIO_MANAGE_CONNECTIONS` meta-tool
19
20
<CodeGroup>
21
```python
22
-session = await composio.create_session(
22
+session = await composio.create(
23
user="pg-user-550e8400-e29b-41d4",
24
)
25
```
26
```typescript
27
-const session = await composio.createSession({
28
- user: "pg-user-550e8400-e29b-41d4",
29
-});
27
+const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4");
28
```
29
</CodeGroup>
30
@@ -36,7 +34,7 @@ Redirect users to a specific page after authentication:
34
35
<CodeGroup>
36
```python
39
-session = await composio.create_session(
37
+session = await composio.create(
38
user="pg-user-550e8400-e29b-41d4",
39
manage_connections={
40
"callback_url": "https://yourapp.com/chat"
@@ -44,8 +42,7 @@ session = await composio.create_session(
42
)
43
```
44
```typescript
47
-const session = await composio.createSession({
48
- user: "pg-user-550e8400-e29b-41d4",
45
+const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4", {
46
manageConnections: {
47
callbackUrl: "https://yourapp.com/chat",
48
},
@@ -59,14 +56,13 @@ To manage authentication outside of chat, disable the `COMPOSIO_MANAGE_CONNECTIO
56
57
<CodeGroup>
58
```python
62
-session = await composio.create_session(
59
+session = await composio.create(
60
user="pg-user-550e8400-e29b-41d4",
61
manage_connections=False,
62
)
63
```
64
```typescript
68
-const session = await composio.createSession({
69
- user: "pg-user-550e8400-e29b-41d4",
65
+const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4", {
66
manageConnections: false,
67
});
68
```
fern/pages/src/tool-router/white-labeling-authentication.mdx
+4
-6
@@ -48,7 +48,7 @@ Pass your auth config ID in the session:
48
49
<CodeGroup>
50
```python
51
-session = await composio.create_session(
51
+session = await composio.create(
52
user="pg-user-550e8400-e29b-41d4",
53
auth_configs={
54
"github": "ac_your_github_config"
@@ -56,8 +56,7 @@ session = await composio.create_session(
56
)
57
```
58
```typescript
59
-const session = await composio.createSession({
60
- user: "pg-user-550e8400-e29b-41d4",
59
+const session = await composio.create("pg-user-550e8400-e29b-41d4", {
60
authConfigs: {
61
github: "ac_your_github_config",
62
},
@@ -75,7 +74,7 @@ You can white-label some toolkits while using Composio's default credentials for
74
75
<CodeGroup>
76
```python
78
-session = await composio.create_session(
77
+session = await composio.create(
78
user="pg-user-550e8400-e29b-41d4",
79
auth_configs={
80
"github": "ac_your_github_config",
@@ -85,8 +84,7 @@ session = await composio.create_session(
84
)
85
```
86
```typescript
88
-const session = await composio.createSession({
89
- user: "pg-user-550e8400-e29b-41d4",
87
+const session = await composio.create("pg-user-550e8400-e29b-41d4", {
88
authConfigs: {
89
github: "ac_your_github_config",
90
slack: "ac_your_slack_config",
fern/snippets/tool-router/python/anthropic-mcp.py
new
+18
@@ -0,0 +1,18 @@
1
+from composio import Composio
2
+from anthropic_agents import Agent, run
3
+
4
+composio = Composio(api_key="your-api-key")
5
+
6
+session = composio.create(user_id="pg-user-550e8400-e29b-41d4")
7
+
8
+agent = Agent(
9
+ name="Personal Assistant",
10
+ instructions="You are a helpful personal assistant.",
11
+ mcp_servers=[session.mcp.url]
12
+)
13
+
14
+result = run(
15
+ agent,
16
+ "Summarize all the emails in my Gmail inbox today"
17
+)
18
+print(result.final_output)
fern/snippets/tool-router/python/in-chat-auth.py
+7
-4
@@ -2,12 +2,12 @@ import asyncio
2
from composio import Composio
3
from agents import Agent, Runner, HostedMCPTool
4
5
-composio = Composio()
5
+composio = Composio(api_key="your-composio-api-key")
6
7
async def chat():
8
- session = await composio.create_session(
9
- user="pg-user-550e8400-e29b-41d4",
10
- )
8
+ print("Creating Tool Router session...")
9
+ session = await composio.create("pg-user-550e8400-e29b-41d4")
10
+ print(f"Tool Router session created: {session.mcp.url}")
11
12
agent = Agent(
13
name="GitHub Assistant",
@@ -19,6 +19,9 @@ async def chat():
19
"server_label": "composio",
20
"server_url": session.mcp.url,
21
"require_approval": "never",
22
+ "headers": {
23
+ "x-api-key": "your-composio-api-key",
24
+ },
25
}
26
)
27
],
fern/snippets/tool-router/python/manual-auth.py
+2
-2
@@ -1,13 +1,13 @@
1
import asyncio
2
from composio import Composio
3
4
-composio = Composio()
4
+composio = Composio(api_key="your-composio-api-key")
5
6
user_id = "pg-user-550e8400-e29b-41d4"
7
required_toolkits = ["gmail", "googlecalendar", "linear", "slack"]
8
9
async def main():
10
- session = await composio.create_session(
10
+ session = await composio.create(
11
user=user_id,
12
manage_connections=False,
13
)
fern/snippets/tool-router/python/openai-agents.py
new
+22
@@ -0,0 +1,22 @@
1
+from composio import Composio
2
+from composio_openai_agents import OpenAIAgentsProvider
3
+from agents import Agent, Runner
4
+
5
+composio = Composio(
6
+ api_key="your-api-key",
7
+ provider=OpenAIAgentsProvider()
8
+)
9
+
10
+session = composio.create(user_id="pg-user-550e8400-e29b-41d4")
11
+
12
+agent = Agent(
13
+ name="Personal Assistant",
14
+ instructions="You are a helpful personal assistant.",
15
+ tools=session.tools()
16
+)
17
+
18
+result = Runner.run_sync(
19
+ agent,
20
+ "Summarize all the emails in my Gmail inbox today"
21
+)
22
+print(result.final_output)
fern/snippets/tool-router/python/quickstart.py
+28
-37
@@ -1,42 +1,33 @@
1
-import asyncio
2
-import os
1
from composio import Composio
4
-from composio_openai_agents import OpenAIAgentsProvider
2
from agents import Agent, Runner, HostedMCPTool
3
7
-async def main() -> None:
8
- # Initialize Composio and create Tool Router session
9
- composio = Composio(
10
- api_key=os.getenv("COMPOSIO_API_KEY"), # Uses env var by default
11
- provider=OpenAIAgentsProvider()
12
- )
13
- session = composio.experimental.tool_router.create_session(
14
- user_id="user@example.com",
15
- toolkits=["gmail", "github"] # Optional: Limit available toolkits
16
- )
17
-
18
- # Set up OpenAI agent with Tool Router MCP endpoint
19
- agent = Agent(
20
- name="Assistant",
21
- instructions="You are a helpful assistant that can access Gmail and GitHub. "
22
- "Help users fetch emails, create issues, manage pull requests, and more.",
23
- tools=[
24
- HostedMCPTool(
25
- tool_config={
26
- "type": "mcp",
27
- "server_label": "tool_router",
28
- "server_url": session['url'],
29
- "require_approval": "never",
30
- }
31
- )
32
- ],
33
- )
4
+composio = Composio(api_key="your-composio-api-key")
5
35
- # Execute the agent
36
- result = await Runner.run(
37
- agent,
38
- "Fetch the contributors to composiohq/composio github repository and email the list to user@example.com"
39
- )
40
- print(result.final_output)
6
+print("Creating Tool Router session...")
7
+session = composio.create("pg-user-550e8400-e29b-41d4")
8
+print(f"Tool Router session created: {session.mcp.url}")
9
42
-asyncio.run(main())
\ No newline at end of file
10
+agent = Agent(
11
+ name="Personal Assistant",
12
+ instructions="You are a helpful personal assistant.",
13
+ tools=[
14
+ HostedMCPTool(
15
+ tool_config={
16
+ "type": "mcp",
17
+ "server_label": "composio",
18
+ "server_url": session.mcp.url,
19
+ "require_approval": "never",
20
+ "headers": {
21
+ "x-api-key": "your-composio-api-key",
22
+ },
23
+ }
24
+ )
25
+ ],
26
+)
27
+
28
+print("Running the OpenAI agent to fetch gmail inbox")
29
+result = Runner.run_sync(
30
+ agent,
31
+ "Summarize all the emails in my Gmail inbox today"
32
+)
33
+print(result.final_output)
fern/snippets/tool-router/typescript/anthropic-mcp.ts
new
+18
@@ -0,0 +1,18 @@
1
+import { Composio } from "@composio/core";
2
+import { Agent, run } from "@anthropic-ai/agent";
3
+
4
+const composio = new Composio({ apiKey: "your-api-key" });
5
+
6
+const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4");
7
+
8
+const agent = new Agent({
9
+ name: "Personal Assistant",
10
+ instructions: "You are a helpful personal assistant.",
11
+ mcpServers: [mcp.url],
12
+});
13
+
14
+const result = await run(
15
+ agent,
16
+ "Summarize all the emails in my Gmail inbox today"
17
+);
18
+console.log(result.finalOutput);
fern/snippets/tool-router/typescript/in-chat-auth.ts
+16
-8
@@ -1,19 +1,27 @@
1
-import { Composio } from "@composio/core";
2
-import { VercelProvider } from "@composio/vercel";
1
import { openai } from "@ai-sdk/openai";
2
+import { experimental_createMCPClient as createMCPClient } from "@ai-sdk/mcp";
3
+import { Composio } from "@composio/core";
4
import { generateText } from "ai";
5
import * as readline from "readline";
6
7
-const composio = new Composio({
8
- provider: new VercelProvider(),
9
-});
7
+const composio = new Composio({ apiKey: "your-composio-api-key" });
8
9
async function chat() {
12
- const session = await composio.createSession({
13
- user: "pg-user-550e8400-e29b-41d4",
10
+ console.log("Creating Tool Router session...");
11
+ const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4");
12
+ console.log(`Tool Router session created: ${mcp.url}`);
13
+
14
+ const client = await createMCPClient({
15
+ transport: {
16
+ type: "http",
17
+ url: mcp.url,
18
+ headers: {
19
+ "x-api-key": "your-composio-api-key",
20
+ },
21
+ },
22
});
23
16
- const tools = await session.tools();
24
+ const tools = await client.tools();
25
const messages: { role: "user" | "assistant"; content: string }[] = [];
26
27
const rl = readline.createInterface({
fern/snippets/tool-router/typescript/manual-auth.ts
+2
-6
@@ -1,16 +1,12 @@
1
import { Composio } from "@composio/core";
2
-import { VercelProvider } from "@composio/vercel";
2
4
-const composio = new Composio({
5
- provider: new VercelProvider(),
6
-});
3
+const composio = new Composio({ apiKey: "your-composio-api-key" });
4
5
const userId = "pg-user-550e8400-e29b-41d4";
6
const requiredToolkits = ["gmail", "googlecalendar", "linear", "slack"];
7
8
async function main() {
12
- const session = await composio.createSession({
13
- user: userId,
9
+ const session = await composio.create(userId, {
10
manageConnections: false,
11
});
12
fern/snippets/tool-router/typescript/openai-agents.ts
new
+22
@@ -0,0 +1,22 @@
1
+import { Composio } from "@composio/core";
2
+import { OpenAIAgentsProvider } from "@composio/openai-agents";
3
+import { Agent, run } from "@openai/agents";
4
+
5
+const composio = new Composio({
6
+ apiKey: "your-api-key",
7
+ provider: new OpenAIAgentsProvider(),
8
+});
9
+
10
+const { tools } = await composio.create("pg-user-550e8400-e29b-41d4");
11
+
12
+const agent = new Agent({
13
+ name: "Personal Assistant",
14
+ instructions: "You are a helpful personal assistant.",
15
+ tools: await tools(),
16
+});
17
+
18
+const result = await run(
19
+ agent,
20
+ "Summarize all the emails in my Gmail inbox today"
21
+);
22
+console.log(result.finalOutput);
fern/snippets/tool-router/typescript/quickstart.ts
+25
-37
@@ -1,41 +1,29 @@
1
-import { Composio } from '@composio/core';
2
-import { OpenAIAgentsProvider } from '@composio/openai-agents';
3
-import { Agent, hostedMcpTool, run } from '@openai/agents';
1
+import { Composio } from "@composio/core";
2
+import { Agent, hostedMcpTool, run } from "@openai/agents";
3
5
-async function main() {
6
- // Initialize Composio with OpenAI Agents Provider
7
- const composio = new Composio({
8
- apiKey: process.env.COMPOSIO_API_KEY,
9
- provider: new OpenAIAgentsProvider()
10
- });
4
+const composio = new Composio({ apiKey: "your-composio-api-key" });
5
12
- // Create a Tool Router session for your user
13
- const session = await composio.experimental.toolRouter.createSession(
14
- 'user@example.com',
15
- {
16
- toolkits: ['gmail', 'github'] // Optional: Limit available toolkits
17
- }
18
- );
6
+console.log("Creating Tool Router session...");
7
+const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4");
8
+console.log(`Tool Router session created: ${mcp.url}`);
9
20
- // Create an agent with Tool Router MCP endpoint
21
- const agent = new Agent({
22
- name: 'Assistant',
23
- instructions: 'You are a helpful assistant that can access Gmail and GitHub. Help users fetch emails, create issues, manage pull requests, and more.',
24
- tools: [
25
- hostedMcpTool({
26
- serverLabel: 'tool_router',
27
- serverUrl: session.url,
28
- }),
29
- ],
30
- });
10
+const agent = new Agent({
11
+ name: "Personal Assistant",
12
+ instructions: "You are a helpful personal assistant.",
13
+ tools: [
14
+ hostedMcpTool({
15
+ serverLabel: "composio",
16
+ serverUrl: mcp.url,
17
+ headers: {
18
+ "x-api-key": "your-composio-api-key",
19
+ },
20
+ }),
21
+ ],
22
+});
23
32
- // Execute the agent
33
- const result = await run(
34
- agent,
35
- 'Fetch the contributors to composiohq/composio github repository and email the list to user@example.com'
36
- );
37
-
38
- console.log(result.finalOutput);
39
-}
40
-
41
-main();
\ No newline at end of file
24
+console.log("Running the OpenAI agent to fetch gmail inbox");
25
+const result = await run(
26
+ agent,
27
+ "Summarize all the emails in my Gmail inbox today"
28
+);
29
+console.log(result.finalOutput);
fern/snippets/tool-router/typescript/vercel.ts
new
+40
@@ -0,0 +1,40 @@
1
+import { openai } from "@ai-sdk/openai";
2
+import { experimental_createMCPClient as createMCPClient } from "@ai-sdk/mcp";
3
+import { Composio } from "@composio/core";
4
+import { stepCountIs, streamText } from "ai";
5
+
6
+const composio = new Composio({ apiKey: "your-composio-api-key" });
7
+
8
+console.log("Creating Tool Router session...");
9
+const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4");
10
+console.log(`Tool Router session created: ${mcp.url}`);
11
+
12
+const client = await createMCPClient({
13
+ transport: {
14
+ type: "http",
15
+ url: mcp.url,
16
+ headers: {
17
+ "x-api-key": "your-composio-api-key",
18
+ },
19
+ },
20
+});
21
+
22
+const tools = await client.tools();
23
+
24
+const stream = await streamText({
25
+ model: openai("gpt-4o"),
26
+ prompt: "Summarize all the emails in my Gmail inbox today",
27
+ stopWhen: stepCountIs(10),
28
+ onStepFinish: (step) => {
29
+ if (step.toolCalls.length > 0) {
30
+ for (const toolCall of step.toolCalls) {
31
+ console.log(`Executed ${toolCall.toolName}`);
32
+ }
33
+ }
34
+ },
35
+ tools,
36
+});
37
+
38
+for await (const textPart of stream.textStream) {
39
+ process.stdout.write(textPart);
40
+}