@devries-cameron20 / composio-1 / commits / 63bf1a4b4
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.

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.