Fetching tools and toolkits - Composio

Fetching for a session

When using sessions, fetch tools through the session object.

List enabled toolkits

session.toolkits() returns toolkits enabled for your session, sorted by popularity. By default, it returns the top 20. Each toolkit includes its slug, name, logo, and connection status.

python

session = composio.create(user_id="user_123")

result = session.toolkits()

for toolkit in result.items:
    print(f"{toolkit.name}: connected={toolkit.connection.is_active if toolkit.connection else 'n/a'}")

</Tab> <Tab value="TypeScript"> ```typescript import { Composio } from '@composio/core'; const composio = new Composio({ apiKey: 'your_api_key' }); // ---cut--- const session = await composio.create("user_123");

const result = await session.toolkits();

for (const toolkit of result.items) { console.log(${toolkit.name}: connected=${toolkit.connection?.isActive ?? 'n/a'}); }

</Tab>
</Tabs>

You can filter to only show connected toolkits:

<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
<Tab value="Python">
```python
connected = session.toolkits(is_connected=True)  # Only connected

</Tab> <Tab value="TypeScript"> ```typescript import { Composio } from '@composio/core'; const composio = new Composio({ apiKey: 'your_api_key' }); const session = await composio.create("user_123"); // ---cut--- const connected = await session.toolkits({ isConnected: true }); // Only connected ``` </Tab> </Tabs>

To fetch all toolkits, paginate through the results:

python

all_toolkits = []
cursor = None

while True:
    result = session.toolkits(limit=20, next_cursor=cursor)
    all_toolkits.extend(result.items)
    cursor = result.next_cursor
    if not cursor:
        break

</Tab> <Tab value="TypeScript"> ```typescript import { Composio } from '@composio/core'; const composio = new Composio({ apiKey: 'your_api_key' }); const session = await composio.create("user_123"); // ---cut--- const allToolkits: any[] = []; let cursor: string | undefined;

do { const { items, nextCursor } = await session.toolkits({ limit: 20, nextCursor: cursor }); allToolkits.push(...items); cursor = nextCursor; } while (cursor);

</Tab>
</Tabs>

### Get meta tools

`session.tools()` returns the [meta tools](/reference/meta-tools) formatted for your configured provider (OpenAI, Anthropic, etc.):

<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
<Tab value="Python">
```python
# Get all meta tools
tools = session.tools()

</Tab> <Tab value="TypeScript"> ```typescript import { Composio } from '@composio/core'; const composio = new Composio({ apiKey: 'your_api_key' }); const session = await composio.create("user_123"); // ---cut--- // Get all meta tools const tools = await session.tools(); ``` </Tab> </Tabs>

To restrict which toolkits or tools are discoverable by the meta tools, configure them when creating the session.

Browsing the catalog

Before configuring a session, you may want to explore what toolkits and tools are available. You can browse visually at platform.composio.dev or in the docs, or fetch programmatically:

python

# List toolkits
toolkits = composio.toolkits.get()

# List tools within a toolkit (top 20 by default)
tools = composio.tools.get("user_123", toolkits=["GITHUB"])

</Tab> <Tab value="TypeScript"> ```typescript import { Composio } from '@composio/core'; const composio = new Composio({ apiKey: 'your_api_key' }); const userId = 'user_123'; // ---cut--- // List toolkits const toolkits = await composio.toolkits.get();

// List tools within a toolkit (top 20 by default) const tools = await composio.tools.get(userId, { toolkits: ["GITHUB"] });

</Tab>
</Tabs>

### Get a tool's schema

To inspect a tool's input parameters and types without needing a user context, use `getRawComposioToolBySlug`:

<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
<Tab value="Python">
```python
tool = composio.tools.get_raw_composio_tool_by_slug("GMAIL_SEND_EMAIL")
print(tool.name)
print(tool.description)
print(tool.input_parameters)
print(tool.output_parameters)

</Tab> <Tab value="TypeScript"> ```typescript import { Composio } from '@composio/core'; const composio = new Composio({ apiKey: 'your_api_key' }); // ---cut--- const tool = await composio.tools.getRawComposioToolBySlug("GMAIL_SEND_EMAIL"); console.log(tool.name); console.log(tool.description); console.log(tool.inputParameters); console.log(tool.outputParameters); ``` </Tab> </Tabs>

What to read next

<Cards> <Card icon={<Wrench />} title="Enable & disable toolkits" href="/docs/toolkits/enable-and-disable-toolkits" description="Control which toolkits and individual tools are available in sessions" /> <Card icon={<Wrench />} title="Tools and toolkits" href="/docs/tools-and-toolkits" description="How meta tools discover, authenticate, and execute tools at runtime" /> <Card icon={<Blocks />} title="Browse toolkits" href="/toolkits" description="Explore all available toolkits and their tools" /> </Cards>