Use hubsell with your AI assistant (MCP)

Connect hubsell to ChatGPT, Claude, Gemini or any other AI assistant that supports MCP, then find contacts, read flow results, tag, enrich and start flows by asking in plain language.

About 5 min·4 steps·Last updated 16 November 2026
Applies to
All hubsell plans. You need your own subscription to an AI app that supports remote MCP servers. Some apps offer this only on certain plans or in certain countries.
Before you start
A hubsell login, and an AI app that supports remote MCP servers, such as ChatGPT, Claude, Gemini, Mistral Vibe, Perplexity, Microsoft Copilot Studio, Cursor or Claude Code.

MCP (Model Context Protocol) is the open standard AI apps use to work with other software. hubsell has an MCP server, so any assistant that can add one can connect: ChatGPT, Claude, Gemini, Mistral Vibe, Microsoft Copilot Studio, Cursor and more. Once you connect it, you can ask things like "Which of my contacts in Germany replied positively?" or "How is my UK flow doing this month?", and your assistant looks up the answer in your hubsell account.

You use your own AI subscription. hubsell doesn't see your chats, charges no credits for the AI, and the assistant can only do what you allow when you connect it.

Connect your assistant

  1. Copy the server address: https://mcp.hubsell.com/mcp. Every app uses the same one. You also find it in hubsell: click your profile icon, then MCP, under Connect your AI assistant.

  2. Add it to your app as a custom MCP server or connector. The menus differ per app; see Steps for each app below.

  3. Your app opens hubsell in your browser. Log in if you aren't already. You then see a page called Connect your app to hubsell, with the name of the app you use.

    Choosing what the assistant may do, here in Claude. The page shows the name of your app, for example ChatGPT, and the site it sends you back to. Read and Write are ticked to start with.
  4. Choose the permissions (see below) and click Allow access. You go back to your app, which is now connected.

Ask your assistant "What's my hubsell account and how many credits do I have?" to check that it works.

Steps for each app

These menus come from each app's own help pages (November 2026) and can change. If a step looks different, check the app's help. Some apps offer custom MCP servers only on certain plans, in certain countries, or when an admin allows it.

ChatGPT

  • On chatgpt.com, open Plugins, click + and choose Add custom MCP server.
  • Enter a name, for example hubsell, paste the address under Server URL and choose OAuth as the authentication.
  • Read the warning, confirm it, click Create as a plugin, then install the plugin and sign in to hubsell.
  • Not every ChatGPT plan can add custom MCP servers, and in Business, Enterprise and Edu workspaces an admin decides who may. Which plans may use actions that change data has changed over time, so check OpenAI's help page for your plan. On some accounts the option is under Settings → Apps → Advanced settings → Developer mode instead.

Claude (web and desktop app)

  • Go to Customize → Connectors, click + Add and choose Add custom connector.
  • Enter the name hubsell, paste the address and click Continue. Keep the sign-in settings Claude suggests and click Add. If signing in fails, choose Register automatically under OAuth client.
  • To use it in a chat, click + at the bottom left, then Connectors, and turn hubsell on.
  • Works on Free (one custom connector), Pro, Max, Team and Enterprise. On Team and Enterprise an owner adds hubsell once under Organization settings → Connectors; everyone then clicks Connect next to it under Customize → Connectors.

Claude Code

  • Run claude mcp add --transport http hubsell https://mcp.hubsell.com/mcp in your terminal, then type /mcp in Claude Code to sign in.

Gemini

  • On gemini.google.com, click Settings, then Connected Apps. Under Custom apps, click Add a custom app, paste the address, click Next and sign in to hubsell.
  • You add it in the web app and can then use it in the web and mobile apps.
  • At the time of writing, Google offers custom apps only to people aged 18 or over in the US, with a personal Google Account (not a work or school account), in English and with Keep Activity on.

Mistral Vibe (formerly Le Chat)

  • Open Connectors, click + Add Connector and switch to the Custom MCP Connector tab.
  • Enter hubsell as the Connector name (no spaces), paste the address under Server URL, click Connect and sign in to hubsell.
  • Only admins can add connectors. On Free, Pro and Student plans the account owner is the admin. Turn the connector on in the chat where you want to use it.

Perplexity

  • Open Plugins in the sidebar (or Customize → Connectors), choose Add custom → Add MCP connector and select Remote.
  • Enter the name hubsell and paste the address as the MCP server URL. Under Advanced, choose OAuth and Streamable HTTP.
  • Tick the acknowledgement, click Add, then click the connector card to sign in to hubsell.
  • In an organisation, an admin has to turn on Allow members to add custom connectors first. Check Perplexity's help for which plans include custom connectors.

Microsoft Copilot Studio

  • For organisations that build their own agents in Copilot Studio. The consumer Microsoft Copilot app is a different product.
  • Open your agent's Tools page, click Add a tool → New tool → Model Context Protocol.
  • Enter hubsell as the Server name, a short Server description (for example Search and update contacts and flows in hubsell) and the address as the Server URL.
  • Choose OAuth 2.0, then Dynamic discovery, and click Create and Next. Choose Create a new connection, sign in to hubsell, then click Add to agent.
  • You need a Copilot Studio licence, and your organisation's data policies can block new connections.

Cursor

  • Add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project): {"mcpServers": {"hubsell": {"url": "https://mcp.hubsell.com/mcp"}}}
  • Open Customize in the sidebar and make sure hubsell is on. Cursor opens the hubsell sign-in.

Codex

  • Run codex mcp add hubsell --url https://mcp.hubsell.com/mcp, then codex mcp login hubsell to sign in.
  • The Codex CLI, the Codex IDE extension and the ChatGPT desktop app share this setting.

Visual Studio Code (GitHub Copilot)

  • Open the Command Palette, run MCP: Add Server, choose HTTP and paste the address.
  • Enter hubsell as the server ID, choose Global, and sign in to hubsell when Visual Studio Code asks.

Windsurf

  • In Cascade's MCP menu, choose Open MCP config file and add {"mcpServers": {"hubsell": {"serverUrl": "https://mcp.hubsell.com/mcp"}}}. Save and press refresh, then sign in to hubsell when asked.
  • In a team, an admin can limit MCP servers to an approved list.

Other apps

  • Any app that can add a remote MCP server (Streamable HTTP) and sign in to it can use the same address. If your app can only send a fixed header, create a personal access token (see Apps that can't sign in).

The four permissions

  • Read: view contacts, lists, flows, templates and statistics.
  • Write: tag contacts, change their status and create lists.
  • Spend credits: enrich contacts. This uses your hubsell credits.
  • Send emails: add contacts to flows and start or pause flows. This can email real people.

Pick only what you need. You can start with Read and connect again later with more.

What you can ask

Your account and team

  • Your account, your plan limits and how many credits you have left.
  • Who is in your team. Example: "Who in my team can send flow emails?"

Contacts

  • Search your contacts by name, email, job title or company, and filter by list, flow, status, tag, seniority, department, industry, company size, the contact's country, the company's country, source and enrichment status. Example: "Find CEOs in the Netherlands in my Angels list."
  • Show everything about one contact: job, company, email, LinkedIn profile, lists, flows and campaigns.
  • List the statuses and tags you use.

Lists, flows and templates

  • List your lists (segments) and your flows, with their basic numbers.
  • Show the results of one flow for any period: sent, opened, clicked, replied, positive and neutral replies, bounces and LinkedIn invitations accepted. Without a period you get the last 30 days. Example: "How did my UK hiring flow do in October?"
  • List your saved email and LinkedIn templates with a preview of each.

Changes (needs Write)

  • Add or remove tags on up to 500 contacts at once.
  • Change the status of contacts, for example to Replied Positive: Next Stage, with an optional note.
  • Create a new, empty list.

Enrichment (needs Spend credits)

  • Find verified emails, or emails and phone numbers, for up to 500 contacts at once. It runs in the background and the results appear on the contacts.

Flows (needs Send emails)

  • Add up to 500 contacts to a flow and choose which teammate sends. Suppressed and locked contacts are skipped.
  • Start or pause a flow.

Before anything is sent or spent

hubsell tells your assistant to ask you before it enriches contacts, adds them to a flow or starts a flow, and to say how many contacts that affects. Read the question before you say yes: once a flow runs, emails and LinkedIn messages go out in the sender's name. If you want to be sure, connect without Spend credits and Send emails.

What it can't do yet

  • Create or edit flows and templates.
  • Delete contacts, lists or flows.
  • Move contacts into a list, import or export contacts.
  • Push contacts to your CRM, run LinkedIn searches, or read and answer replies.
  • Change your account or team settings.

Do these in the app. We add new abilities regularly.

Your role applies

The assistant acts as you. It sees what you see in hubsell and can only change what your role allows (see Roles and permissions). When you change many contacts at once, it tells you how many were skipped and why, for example because they belong to a teammate.

See and disconnect your connections

Click your profile icon, then MCP. The list shows every connected app and personal access token, when it was last used and what it may do. Click Revoke to cut off its access straight away. A connected app also disconnects by itself after 90 days without use.

Apps that can't sign in

Some scripts and tools can't open the hubsell sign-in page. For those, create a personal access token instead:

  1. Click your profile icon, then MCP, and click Create token.

  2. Enter a Name you'll recognise, for example Codex on my laptop, pick the permissions and how long it lasts, and click Create token.

  3. Copy the token. For your security it won't be shown again. Send it as a Bearer header to https://mcp.hubsell.com/mcp.

You can have up to 20 active tokens. Treat a token like a password: anyone who has it can use hubsell as you, within its permissions.

Common questions

Which apps work?

Any app that can add a remote MCP server by its address and sign in to it. The steps for ChatGPT, Claude, Claude Code, Gemini, Mistral Vibe, Perplexity, Microsoft Copilot Studio, Cursor, Codex, Visual Studio Code and Windsurf are above. They all use the same address.

My app isn't in the list. Will it work?

If it can add a remote MCP server and sign in with it, use the address https://mcp.hubsell.com/mcp. If it can only send a fixed header, create a personal access token (see Apps that can't sign in).

Does this use hubsell credits?

Only enrichment does, exactly as in the app. Everything else is free. The AI itself runs on your own subscription, not on hubsell credits.

Can hubsell read my chats with my assistant?

No. Your assistant only sends hubsell the questions it needs answered, such as a contact search, and gets the results back. hubsell never sees your conversation.

Can the assistant change a teammate's contacts or flows?

Only if your role allows it. The assistant acts as you, with your role and permissions. When something isn't allowed, it is told so and tells you why.

Can it email someone without asking me?

Only if you gave it the Send emails permission. hubsell tells the assistant to ask you before it adds contacts to a flow or starts a flow, but the safest way is to leave Send emails off until you need it.

How do I stop it?

Click your profile icon, then MCP, and click Revoke next to the connection. It loses access straight away.