Skip to main content

Use The Swarm in Claude, ChatGPT and HubSpot (MCP)

Use The Swarm in ChatGPT with the plugin, in HubSpot Breeze agents with The Swarm MCP app, or in Claude and other AI assistants with MCP.

Written by Bee Keeper

The Swarm MCP lets you use The Swarm inside AI assistants such as Claude, ChatGPT and HubSpot Breeze agents. Ask in plain language, for example "Who on our team knows someone at Acme?", and the assistant answers with your team's Swarm data.

Connect in ChatGPT

  1. Open The Swarm plugin for ChatGPT and sign in to ChatGPT if asked.

  2. Select Connect.

  3. Sign in with your Swarm account.

  4. On the Allow access screen, pick your team if you belong to more than one, then select Allow access.

  5. Start a new chat and ask about your network.

On a ChatGPT Business or Enterprise workspace, an admin may need to enable the plugin first.

Connect in HubSpot

Install The Swarm MCP from the HubSpot Marketplace, then add it to a Breeze agent in Agent Builder:

  1. In HubSpot, go to Agent Hub > Agent Builder and open an agent.

  2. Click Configure, then Add tool.

  3. On the MCP Servers tab, find The Swarm MCP and click Connect and add.

  4. Sign in with your Swarm account, choose your team and click Allow access.

Full steps: Connect in HubSpot


Connect in Claude and other assistants

Step-by-step setup, example prompts and the full list of tools are in our developer docs: The Swarm MCP guide.

Good to know

  • Who can use it: Owners, Admins and Contributors. Guests can't use MCP. See User roles and permissions.

  • Plans: MCP is part of the API, so it's included in the trial, Premium and Enterprise plans. It isn't available on the Free plan or after a trial or plan expires.

  • Credits: MCP uses your team's API credits. In-network intro paths are free. See How MCP uses credits.

If it doesn't connect

  • If you see 'You don't have permission to authorize apps for this team', you're a Guest or your team is on the Free plan. Ask an Owner or Admin.

  • If Claude, ChatGPT or HubSpot says you're authorized but don't have access, your trial or plan has expired, or you chose a different team on the Allow access screen.

  • In Claude, the connector works on claude.ai and in the desktop app: Settings → Connectors → Add custom connector, with the URL https://bee.theswarm.com/mcp.

Trouble connecting? Contact support@theswarm.com with the assistant you're using and any error message you see.

Did this answer your question?