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: clarify that all toolkits are available by default in sessions
Common question from users — added notes across quickstart, FAQ, configuring sessions, and tools & toolkits pages explaining that sessions have access to the entire catalog unless explicitly restricted. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sushmitha Mallesh committed
Feb 24, 2026 at 00:33 UTC
63bf1a4b4c926f65a6bfc44532b1868ac136f94f
4 files changed
+48
docs/content/docs/common-faq.mdx
+32
@@ -28,6 +28,38 @@ If you don't have an agent, you can [execute tools directly](/docs/tools-direct/
28
You can browse all toolkits on the [Toolkits page](/toolkits) in the docs or in the [Composio dashboard](https://platform.composio.dev?next_page=/marketplace). Both list every supported app along with available auth schemes and tools.
29
</Accordion>
30
31
+<Accordion title="What toolkits are available by default in a session?">
32
+All toolkits in the Composio catalog are available by default. When you create a session without specifying a `toolkits` parameter, your agent can discover and use any toolkit through `COMPOSIO_SEARCH_TOOLS`.
33
+
34
+To restrict which toolkits are available, pass `toolkits` when creating the session:
35
+
36
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
37
+<Tab value="Python">
38
+```python
39
+# Only GitHub and Gmail
40
+session = composio.create(user_id="user_123", toolkits=["github", "gmail"])
41
+
42
+# Everything except Linear and Jira
43
+session = composio.create(user_id="user_123", toolkits={"disable": ["linear", "jira"]})
44
+```
45
+</Tab>
46
+<Tab value="TypeScript">
47
+```typescript
48
+import { Composio } from '@composio/core';
49
+const composio = new Composio({ apiKey: 'your_api_key' });
50
+// ---cut---
51
+// Only GitHub and Gmail
52
+const session = await composio.create("user_123", { toolkits: ["github", "gmail"] });
53
+
54
+// Everything except Linear and Jira
55
+const session2 = await composio.create("user_123", { toolkits: { disable: ["linear", "jira"] } });
56
+```
57
+</Tab>
58
+</Tabs>
59
+
60
+You can also list the toolkits available in a session with `session.toolkits()`. See [Enable and disable toolkits](/docs/toolkits/enable-and-disable-toolkits).
61
+</Accordion>
62
+
63
<Accordion title="The tool I need doesn't exist. How do I request one?">
64
You can request new tools or toolkits on the [tool request board](https://request.composio.dev/boards/tool-requests). The team reviews requests regularly.
65
</Accordion>
docs/content/docs/configuring-sessions.mdx
+2
@@ -22,6 +22,8 @@ const session = await composio.create("user_123");
22
</Tab>
23
</Tabs>
24
25
+By default, a session has access to **all toolkits** in the Composio catalog. Your agent can discover and use any of them through `COMPOSIO_SEARCH_TOOLS`. Use the options below to restrict or customize what's available.
26
+
27
## Enabling toolkits
28
29
Restrict the session to specific toolkits:
docs/content/docs/quickstart.mdx
+4
@@ -826,6 +826,10 @@ readline.close();
826
827
</QuickstartFlow>
828
829
+<Callout type="info">
830
+By default, sessions have access to **all available toolkits** in the Composio catalog. Your agent can discover and use any of them through `COMPOSIO_SEARCH_TOOLS`. To restrict which toolkits are available, see [Enable and disable toolkits](/docs/toolkits/enable-and-disable-toolkits).
831
+</Callout>
832
+
833
## Next steps
834
835
<Cards>
docs/content/docs/tools-and-toolkits.mdx
+10
@@ -68,6 +68,16 @@ A **tool** is an individual action your agent can execute. Each tool has an inpu
68
If you know exactly which tools you need, you can [execute them directly](/docs/tools-direct/executing-tools) without meta tools.
69
</Callout>
70
71
+## Default toolkit access
72
+
73
+<Accordions>
74
+<Accordion title="What toolkits can my agent access by default?">
75
+All of them. When you create a session without specifying a `toolkits` parameter, every toolkit in the Composio catalog is discoverable through `COMPOSIO_SEARCH_TOOLS`. The agent searches for relevant tools at runtime — it doesn't load them all into context at once.
76
+
77
+To restrict which toolkits are available, pass `toolkits` when creating the session. See [Enable and disable toolkits](/docs/toolkits/enable-and-disable-toolkits).
78
+</Accordion>
79
+</Accordions>
80
+
81
## Authentication
82
83
Tools execute with the user's authenticated credentials. When a user connects their GitHub account, all GitHub tools run with their permissions.