Skip to content

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

Sushmitha Mallesh63bf1a4b4c92
diff --git a/docs/content/docs/common-faq.mdx b/docs/content/docs/common-faq.mdx
index 4d4f14b9e..10cd10448 100644
--- a/docs/content/docs/common-faq.mdx
+++ b/docs/content/docs/common-faq.mdx
@@ -28,6 +28,38 @@ If you don't have an agent, you can [execute tools directly](/docs/tools-direct/
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.
</Accordion>
+<Accordion title="What toolkits are available by default in a session?">
+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`.
+
+To restrict which toolkits are available, pass `toolkits` when creating the session:
+
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+<Tab value="Python">
+```python
+# Only GitHub and Gmail
+session = composio.create(user_id="user_123", toolkits=["github", "gmail"])
+
+# Everything except Linear and Jira
+session = composio.create(user_id="user_123", toolkits={"disable": ["linear", "jira"]})
+```
+</Tab>
+<Tab value="TypeScript">
+```typescript
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: 'your_api_key' });
+// ---cut---
+// Only GitHub and Gmail
+const session = await composio.create("user_123", { toolkits: ["github", "gmail"] });
+
+// Everything except Linear and Jira
+const session2 = await composio.create("user_123", { toolkits: { disable: ["linear", "jira"] } });
+```
+</Tab>
+</Tabs>
+
+You can also list the toolkits available in a session with `session.toolkits()`. See [Enable and disable toolkits](/docs/toolkits/enable-and-disable-toolkits).
+</Accordion>
+
<Accordion title="The tool I need doesn't exist. How do I request one?">
You can request new tools or toolkits on the [tool request board](https://request.composio.dev/boards/tool-requests). The team reviews requests regularly.
</Accordion>
diff --git a/docs/content/docs/configuring-sessions.mdx b/docs/content/docs/configuring-sessions.mdx
index 43bcc5127..be79c7180 100644
--- a/docs/content/docs/configuring-sessions.mdx
+++ b/docs/content/docs/configuring-sessions.mdx
@@ -22,6 +22,8 @@ const session = await composio.create("user_123");
</Tab>
</Tabs>
+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.
+
## Enabling toolkits
Restrict the session to specific toolkits:
diff --git a/docs/content/docs/quickstart.mdx b/docs/content/docs/quickstart.mdx
index 82bb993f1..e829cee00 100644
--- a/docs/content/docs/quickstart.mdx
+++ b/docs/content/docs/quickstart.mdx
@@ -826,6 +826,10 @@ readline.close();
</QuickstartFlow>
+<Callout type="info">
+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).
+</Callout>
+
## Next steps
<Cards>
diff --git a/docs/content/docs/tools-and-toolkits.mdx b/docs/content/docs/tools-and-toolkits.mdx
index 05ef97119..4897fdafd 100644
--- a/docs/content/docs/tools-and-toolkits.mdx
+++ b/docs/content/docs/tools-and-toolkits.mdx
@@ -68,6 +68,16 @@ A **tool** is an individual action your agent can execute. Each tool has an inpu
If you know exactly which tools you need, you can [execute them directly](/docs/tools-direct/executing-tools) without meta tools.
</Callout>
+## Default toolkit access
+
+<Accordions>
+<Accordion title="What toolkits can my agent access by default?">
+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.
+
+To restrict which toolkits are available, pass `toolkits` when creating the session. See [Enable and disable toolkits](/docs/toolkits/enable-and-disable-toolkits).
+</Accordion>
+</Accordions>
+
## Authentication
Tools execute with the user's authenticated credentials. When a user connects their GitHub account, all GitHub tools run with their permissions.