SPOTTER | Your Hubspot Helper

📢 Announcement

Run HubSpot Straight From Your Terminal with the New Agent CLI (If You Can Get In)

HubSpot just dropped a look at their vision for the "agent era," and if you are an operations nerd or a developer who lives inside tools like Claude Code, Claude Cowork, or OpenAI Codex, this one is going to make you sit up.

But first, the bad news: It is currently a private beta, and many users, including me, as I write this, are still stuck on the waiting list staring at a closed door.

However, what they are building is absolutely worth putting on your radar while we all wait for access.

It is called the HubSpot Agent CLI, and the simplest way to think about it is this: it brings your CRM data directly into your AI agent workspaces so you can automate repetitive, bulk, and scheduled work before you even get to your desk in the morning.

Instead of jumping into HubSpot to build a massive, complex workflow or manually filtering through lists, you can just tell your AI agent to do the heavy lifting using standard prompts.

Imagine being able to tell your workspace:

  • For Marketers: "Every Monday at 8 AM, find high-fit contacts with no associated deal and missing enrichment fields, then send RevOps a prioritized cleanup list."

  • For Sales Ops: "Every morning at 7 AM, check the pipeline for deals closing this week with zero activity in the last 5 days and summarize them for me."

  • For Support Teams: "Pull the last 5 tickets from this contact, summarize how we resolved them, and flag any recurring issues."

The big idea here is optionality. HubSpot is trying to build an open ecosystem where your AI agents aren't locked into just one infrastructure, they can use whatever tool is best for the specific task at hand.

When you do finally get the golden ticket into the beta, setup looks pretty straightforward. You copy a quick installation script (using a curl command for Mac/Linux or an irm command for PowerShell) directly into Cowork or Codex, run hubspot auth login to link your portal, and start prompting.

⚠️ A quick warning from their early docs: Because these agents can technically overwrite or delete CRM data if you tell them to, you will absolutely want to use the --dry-run flag to preview changes before letting the AI loose in your live portal.

If you want to get on the list to try it out, a Super Admin in your account needs to go request beta access.

Hopefully, the gatekeepers let us all in soon so we can actually see if it lives up to the hype.

🔄 Try

Something small to test or improve this week.

Use Workflow Comments Before Your Automation Becomes an Unsolved Mystery

If your HubSpot portal has more than one person building or managing automation, your workflow tool probably contains a few hidden logic traps that everyone is terrified to touch.

You know the vibe:

"Why is there a random 4-day delay right before this internal notification?"

"Who added this specific enrollment branch for contacts with a lifecycle stage of Opportunity?"

"Is this webhook actually doing something critical, or will deleting it break the entire tech stack?"

"Do not touch this action, John built it two years ago and he doesn't work here anymore."

This is where the workflow commenting tool is quietly very useful.

Instead of relying on a completely separate Slack thread, an outdated Google Doc, or the emotional memory of your marketing team, you can drop context-rich notes directly onto specific workflow actions.

Think of workflow comments like a built-in paper trail that explains the why behind your logic:

Why did we change this property update? What edge case does this specific branch protect against? Who approved this routing logic? Is this action temporary for a seasonal campaign, or is it a permanent fixture holding up the CRM with duct tape and vibes?

This is especially helpful for keeping everyone in the account on the same page without leaving the builder. Instead of messaging a teammate to say, "Hey, can you look at the new deal routing workflow?" and having them hunt through the portal, you can @mention them directly on the exact action that needs their eyes. They get a notification, jump straight to the correct step, and reply in a clean, threaded conversation right inside the canvas.

My favorite ways to implement this:

  • The "Why It's Weird" Note: Leave a comment on any complex or counter-intuitive branch explaining exactly why you set it up that way so the next admin doesn't undo your hard work.

  • The Peer Review Tag: Before hitting "Review and turn on," tag a teammate on the trigger step to get a second pair of eyes on your enrollment criteria.

  • The Change Log: Drop a quick comment whenever you modify a live workflow ("Updated action on June 8 to route to the new Western regional team").

That tiny bit of structure turns a workflow from a terrifying black box into a transparent, shared map that the whole team can confidently collaborate on.

👋 Need a Spot?

Want help cleaning up your HubSpot portal or setting up something smarter?

Let’s talk about what hands-on help could look like for your team.

Email me here or DM me on Linkedin.

Keep Reading