Skip to main content

HubSpot from the command line

Contacts, companies, deals, tickets and the activity behind them. GBrain Tools gives HubSpot, and every other application you connect, a command line for one price.

Get Tools, $19 a month

One price for one person: HubSpot and every other application GBrain connects, from a terminal or any AI. Cancel any time.

Install the CLI, then connect HubSpot

HubSpot is connected on its own sign-in page, in the browser, through an application you make for GBrain in HubSpot. A key or a sign-in never passes through the terminal.

# Install the CLI
curl -sSL https://gbrainio.terminalwire.sh | bash

# Set the terminal up and connect it
gbrainio terminal connect

# What HubSpot is, and each of its commands once it is connected
gbrainio tool help hubspot

The installer is a shell script for macOS and Linux. Read it before you run it.

What GBrain can do with HubSpot

HubSpot is where many sales, marketing and support teams keep their contacts, deals and conversations. Connected to a workspace, GBrain can answer “which deals have gone quiet this month?”, brief someone on a company before a call, or pull together what a contact has heard from the team.

HubSpot lets an AI in through an MCP connector made in the HubSpot account. You make one for GBrain once, paste its client ID and secret, and sign in on HubSpot’s own page. GBrain sees and changes only what each person’s own HubSpot login can, and you choose in each workspace whether it may only read or also make changes.

Why HubSpot takes an extra step

Most applications let GBrain register itself the first time someone signs in. HubSpot doesn’t: its MCP server only accepts a connector that someone in the HubSpot account has made. So each HubSpot account makes one for GBrain, once, and everyone who connects from that account uses it.

Setting it up

  1. In HubSpot, open Development, then MCP Connectors, and create an MCP connector for GBrain.
  2. Enter this as its redirect URL: https://gbrain.io/oauth/mcp/callback
  3. In GBrain, open Tools, then Add an application, and choose HubSpot.
  4. Paste the connector’s client ID and client secret, and press Sign in to HubSpot.
  5. Approve GBrain on HubSpot’s own sign-in page.

From then on it renews and disconnects like any other sign-in. GBrain keeps the client secret encrypted, sends it only to mcp.hubspot.com, HubSpot’s sign-in, and no AI or workspace ever receives it. When you disconnect, it is deleted once HubSpot has been told.

  • Look up contacts, companies, deals and tickets
  • Read calls, emails, meetings, notes and tasks
  • Read campaigns, landing pages and marketing email results
  • See and change only what the person's own HubSpot login can

What a terminal may do with HubSpot, and what GBrain keeps

Off or On, for each terminal

Each terminal reaches HubSpot at the level set for it in the browser: Off, or On, which is every command HubSpot's server lists. A terminal reads its level and never raises it.

1,000 actions a day for each command

Each of HubSpot's commands stops at 1,000 actions a day on the account it reaches, whichever terminal or AI asks, and starts again at midnight UTC. Only that command stops.

Every action on one record

Each command a terminal runs on HubSpot is a row on GBrain's activity log: which terminal, which account, what it did and whether it was allowed, refusals included. gbrainio activity ls --tool hubspot reads it back.

From a terminal, Claude Code or Codex

HubSpot's own server lists its commands only to a terminal that has connected it, so they are not on this page. Once HubSpot is connected, gbrainio tool help hubspot says what each of them does, and gbrainio tool ls lists them with everything else the terminal can run. Claude Code and Codex run the same commands, at the same level, on the same record.

From HubSpot

GBrain reaches HubSpot at its own server, mcp.hubspot.com. On HubSpot's own pages: its website, how the connection works, its terms of service and its privacy policy.

The GBrain Tools command line works with every other application GBrain connects, each with a page like this one.

Every application's command line

HubSpot from a terminal, with GBrain Tools

Tools is $19 a month for one person. Get Tools, connect HubSpot in the browser, and say how far each terminal and each AI may go with it. Change any of it, or take all of it back, whenever you want.