Share this
Audit Your HubSpot Portal With AI, Without Changing a Thing
by Jeffrey D'Entremont on Nov 17, 2026, 10:45:00 AM
Someone in the leadership meeting asks a simple question: how many active customers do we have? You know the answer is in HubSpot. You also know three different properties might hold it, two are half-filled, and one was created by an admin who left in 2022. So you say "let me get back to you" and spend the afternoon in exports.
That's the quiet tax of a portal nobody can see all at once. Every object, custom property and association was added for a good reason by someone, at some point. Nobody ever stepped back to look at the whole map. And now you're being asked to put AI on top of it.
If you're responsible for revenue clarity, that's an uncomfortable place to sit. You're supposed to have the answers. You're just not sure the system underneath you can give them.
The Problem Isn't Your Team. It's Portal Drift.
Portals don't break all at once. They drift. A rep needs a field, so someone creates one. Marketing launches a campaign, so a new lifecycle workaround appears. An integration syncs in properties nobody asked for. A few years and a few admins later, you have hundreds of properties and objects that don't connect the way revenue actually moves.
Nobody did anything wrong. Each decision made sense on the day it was made. But disconnected systems and dirty data don't announce themselves. They show up as a forecast you have to caveat and dashboards that tell three different stories.
Good leaders make bad decisions when their data can't be trusted. That's a systems problem, not a people problem. And you can't fix a system you can't see.
What Changed: AI Can Now Read Your Portal Without Changing It
Until now, seeing your whole portal meant a consultant clicking through settings for days, or someone exporting property lists into a spreadsheet. The HubSpot Agent CLI changes that. It's a command-line tool that lets an AI agent, such as Claude or ChatGPT Codex, connect to your HubSpot account and read its structure directly.
HubSpot's Ecosystem Mentorship Program built a hands-on workshop around it. The design choice I like most is the first rule: read-only. The agent doesn't create, edit, delete or import anything. It looks, it reports, and you decide.
That distinction matters. AI won't fix operational chaos; it accelerates it. Point an agent at your CRM and tell it to "clean things up," and you get confident, automated wrong answers, faster. Point it at your CRM and ask it to show you what's there, and you get something different. That isn't AI running your foundation. It's AI helping you finally see it.
A 3-Step Read-Only Audit You Can Run This Week
The order matters more than the effort. Here's how to sequence it.
- Map what you actually have. Ask the agent to build a HubSpot Account Map: every object, its properties, record counts, and how objects associate with each other. The output is a single HTML file you can open in a browser and share with your team.
- What good looks like: you can explain every custom object and the five properties your team relies on most.
- The tell that it's broken: properties nobody fills in, two properties doing one job, or objects with records but no associations.
- Diagnose what matters most. Ask for up to three improvements, each backed by evidence from the map and ranked by impact and effort. Three, not thirty. The limit forces the agent, and you, to prioritize.
- The tell that it's broken: every recommendation reads like a generic best practice instead of pointing to something specific in your portal.
- Plan the next move on paper. Have the agent design one follow-up workflow, with guardrails, prerequisites and a reusable prompt. Don't run it yet. This is where you decide whether the fix is a quick cleanup or a foundation rebuild.
A starter prompt for step 1:
Using the HubSpot Agent CLI, build a read-only map of my HubSpot account. List every standard and custom object, its properties, record counts, and associations. Do not create, edit, delete or import anything. Save the result as hubspot-account-map.html.
If this order sounds familiar, it's the same one we follow with clients across 100+ HubSpot CRM implementations: understand the reality behind the CRM, stabilize the foundation, then operationalize growth and AI. The agent just makes the first step faster.
Four Guardrails Before You Start
- Say "read-only" out loud. Put it in every prompt. The goal is visibility, not change.
- Never paste tokens or credentials into the chat. Sign in through the CLI's browser login (
hubspot auth login) and let it handle access. - Get the right approvals first. A HubSpot admin may need to approve the Agent CLI connection. On Claude Team or Enterprise plans, an admin may need to turn on code execution, file creation and network access to
api.hubapi.com. HubSpot's setup and IT requirements cover the details. - Treat the output as a draft, not a verdict. The agent sees structure and counts. It doesn't know why your team built that field in 2022. That still takes a conversation with the people who use the system every day.
What's at Stake, and What's on the Other Side
Skip this step, and the portal keeps drifting. Your team keeps building spreadsheets on the side. And when AI gets layered on top, it scales whatever definitions and data you already have. Bad data doesn't get smarter. It gets faster.
Run it, and the next leadership meeting looks different. You know what's in the portal, which three things to fix first, and why. You're not defending the pipeline or reconciling three dashboards. You're the one with the map, and you can spend your time improving revenue instead of explaining reports.
Your Next Step
Not ready to install a CLI? Start with the RevOps Foundation Scorecard. It takes five minutes and shows you where your foundation stands across all three steps, so you know where to start. Take the Scorecard →
Already ran the map and want a second set of eyes on what it found? Schedule a Call. We'll help you separate the cosmetic findings from the ones holding your revenue back.
AI Ready. Foundation First.
Share this
- best practices (66)
- Marketing (45)
- inbound marketing (35)
- Sales (32)
- AI (25)
- Sales Enablement (21)
- artificial intelligence (20)
- hubspot (16)
- ROI (11)
- revops (7)
- CRM (5)
- Data Quality & CRM Health (5)
- automation (3)
- implementation (3)
- onboarding (3)
- CRM Audit (2)
- HubSpot How-To (2)
- properties (2)
- AI Readiness (1)
- Apollo (1)
- CRM Data (1)
- HubSpot Integrations (1)
- Pipeline & Forecasting (1)
- RevOps Foundation (1)
- Sequences (1)
- Tech Stack (1)
- Workflows (1)
- customer support (1)
- dashboards and reporting (1)
- integrations (1)
- lists (1)
- offboarding (1)
- service hub (1)
- November 2026 (1)
- October 2026 (1)
- September 2026 (2)
- August 2026 (1)
- July 2026 (2)
- June 2025 (1)
- May 2025 (4)
- April 2025 (1)
- February 2025 (1)
- September 2024 (2)
- August 2024 (4)
- July 2024 (3)
- June 2024 (3)
- May 2024 (3)
- April 2024 (9)
- March 2024 (13)
- February 2024 (8)
- December 2023 (11)
- November 2023 (6)
- October 2023 (9)
- September 2023 (6)
- August 2023 (4)
- July 2023 (5)
- March 2023 (3)

No Comments Yet
Let us know what you think