> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blackmountain.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools and Toolsets

> Give an assistant access to your integrations through a toolset

A toolset is a named bundle of integrations and the tools you want from each one. Assign a toolset to an assistant and the assistant can look things up and act in those services during a chat, for example search your drive or read a ticket. Toolsets need the **Integrations** feature for your organization.

## How it works

1. Each person connects their own accounts under **Integrations** → **Connections**.
2. Someone bundles the integrations into a toolset under **Integrations** → **Toolsets**.
3. The toolset is assigned to an assistant, or picked directly in the chat composer.
4. In the chat, the assistant calls those tools while it answers.

Tools always run with the account of the person who sends the message. One person's connection never works for anyone else.

## Create a toolset

1. Open **Integrations** and switch to the **Toolsets** tab.
2. Click **Create toolset**.
3. Enter a **Name** and, optionally, a **Description** and icon.
4. Under **Visibility**, choose **Private**, **Team**, **Workspace** or **Organization**.
5. Under **Servers & tools**, click **Add a server** and pick an integration.
6. Switch individual tools on or off.

You can only add an integration you have already connected in this organization. Integrations you still need to connect are marked **Connect first**, with a link to the connections page.

### Choose the tools

Each integration in a toolset has a default switch, and each of its tools can override it:

* The integration's default decides whether its tools are on.
* Switch a single tool **On** or **Off** to override the default.
* Click **Reset to server default** to remove an override.
* Click **Refresh tools** if an integration's tool list is out of date.

> [!TIP]
>
> Keep toolsets small. Only switch on the tools the assistant needs. Fewer tools make the assistant faster and more predictable, and limit what it can do in your accounts.

### Who can use and edit a toolset

| Visibility | Who can use it | Who can edit it |
| - | - | - |
| **Private** | Only you | Only you |
| **Team** | Members of the team | You, and Managers or Owners of the team |
| **Workspace** | Members of the workspace | You, and Managers or Owners of the workspace |
| **Organization** | Everyone in the organization | You, and Managers or Owners of the organization |

To share a toolset, you must be a Manager or Owner of the scope you share it with. If you can only view a toolset, the editor shows **You have view-only access to this toolset.**

## Assign a toolset to an assistant

1. Open the assistant in **Assistant Studio** and click **Edit**.
2. Under **Tools**, pick a toolset in **Toolset**. Choose **None** to remove it.
3. Click **Update**.

The list shows the toolsets you have access to. Tools from the assistant's toolset are combined with any toolset the user selects in the chat.

### When the toolset is shared more narrowly than the assistant

If the toolset reaches fewer people than the assistant, the editor tells you. For example: "These tools only work for you and members of Sales. Other users of this assistant won't see them." Other people can still use the assistant, just without those tools.

To give everyone the tools, share the toolset with the same scope as the assistant. Each person still needs to connect their own accounts.

## Integration status in a toolset

The toolset editor marks integrations that won't run for you in the current organization. Their tools are dimmed.

| Badge | Meaning |
| - | - |
| **Connect required** | Connect this integration to use its tools here. |
| **Reconnect required** | Your connection stopped working. Reconnect it. |
| **Not enabled in this org** | The integration isn't enabled for your organization. |
| **Disabled** | The integration has been disabled. Its tools won't run until it is approved again. |
| **Removed** | The integration was removed from the catalog. Remove it from the toolset. |

## Other tools for assistants

Besides a toolset, the **Tools** section can hold:

* **Skills**: reusable instructions the assistant loads when relevant. See [Configure an assistant](https://docs.blackmountain.io/assistants/configuration.md#skills).
* **Newsroom**: customer lookups and social media research. See [Newsroom](https://docs.blackmountain.io/modules/newsroom).
* **Transport order → v4 CSV**: turns transport orders into import-ready CSV files. See [Freightcheck](https://docs.blackmountain.io/modules/freightcheck.md).

Each option only appears when your organization has the matching feature.

Built-in tools such as web search, image generation and document generation are not part of the assistant. You turn them on per chat in the composer.

## Related

> [card] [Connections](https://docs.blackmountain.io/integrations/connections.md)
>
> Connect your accounts.

> [card] [Integrations in chat](https://docs.blackmountain.io/chat/tools/integrations-in-chat.md)
>
> Pick a toolset or integration directly in a chat.

> [card] [Toolsets for admins](https://docs.blackmountain.io/admin/integrations/toolsets.md)
>
> Plan toolsets for your organization.

> [card] [Visibility and sharing](https://docs.blackmountain.io/assistants/visibility-and-sharing.md)
>
> How assistant access works.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.