HubSpot Admin Skills37 Claude Code skills that audit, clean, enrich, and automate a HubSpot CRM from the terminal, running plain-Python scripts against HubSpot's REST APIs with before-and-after checks on every change.
Repo
HubSpot Admin Skills
37 Claude Code skills that audit, clean, enrich, and automate a HubSpot CRM from the terminal, running plain-Python scripts against HubSpot's REST APIs with before-and-after checks on every change.
The most complete HubSpot admin toolkit built as Claude Code skills: 37 skills across audit, hygiene, enrichment, scoring, and workflow automation, all MIT and free. It is written by a real HubSpot practitioner, and the safety engineering is unusually careful for a project this size, with before-and-after checks, abort thresholds, CSV audit trails, and a production-locked sandbox self-test. The honest catches are its size and age. 67 stars, one maintainer, no code push since July 2026, and the scripts run with write and delete scopes against your live CRM.
Great for
RevOps and marketing admins who live in HubSpot and want repeatable, audit-then-fix cleanup: dedupe, suppression, enrichment, lead scoring, and workflow builds driven from Claude Code instead of 40 manual clicks per task.
The catch
Every scripted skill executes Python with contact, company, and deal write scopes against your real portal, including deletes, merges, and suppressions. Read each SKILL.md, run the sandbox self-test first, and keep the CSV baselines.
Bottom line
A genuinely well-designed HubSpot cleanup kit from someone who knows the platform, held back mainly by its youth. 67 stars and one maintainer mean thin community support, so treat it as a strong starting point you own and verify, not a hands-off service.
Install/plugin marketplace add tomgranot/hubspot-admin-skills then /plugin install hubspot-admin@hubspot-admin-skills, or git clone the repo
LicenseMIT
LanguagePython (Markdown skill files, scripts run with uv)
Maintained byTom Granot (SyntaxGTM), solo maintainer, most commits co-authored with Claude Code
Harnesses supportedClaude Code (plugin plus skills); HubSpot's official remote MCP server wires in optionally for conversational reads
Watch out forYoung 67-star repo, one maintainer, scripts run with write and delete scopes on your live CRM, no code push since July 2026
Full portal audit with A-F gradingContacts, companies, deals, properties, lists, workflows, forms, each finding mapped to a fix skill
Phased implementation planDependency-sequenced roadmap with time estimates and script-versus-manual labeling
Database hygiene (delete, suppress, merge, reassign)No-email deletes, bounce and unsubscribe and ghost suppression, domain-plus-fuzzy company merge, owner reassignment
Internal enrichment (name, industry, geo, lifecycle)Backfills from associated records, form data, and IP geolocation, and corrects lifecycle-stage violations
External waterfall enrichmentNeeds your own provider API key and credits: FullEnrich, Apollo, Hunter, Dropcontact, or a custom adapter
Lead scoring (Fit, Engagement, decay)Designs the model and API-readable score properties, but the model is built in HubSpot's UI scoring tool
ICP tiers and smart listsFirmographic ICP tier property plus active smart lists for segments and suppression groups
Workflow automation via v4 APIWorkflows created disabled for UI review; needs a Marketing Professional plan or higher
Workflows-as-code backup and restoreExport every workflow to versioned JSON, diff exports over time, restore from backup
Sandbox self-test, production-lockedSeeds, smoke-tests, and tears down on a disposable developer account; refuses any non-sandbox portal
Official HubSpot MCP integrationOptional /connect-hubspot-mcp for conversational reads alongside the bulk scripts
Safety pattern (rollback, abort thresholds, CSV trails, confirmation)Every state-changing skill audits, exports a baseline, confirms, then verifies before and after
What it does
- Runs a full portal audit across contacts, companies, deals, properties, lists, workflows, and forms, and returns a graded A-F report that maps each finding to the skill that fixes it
- Generates a phased implementation plan from the audit, sequenced by dependency (enrich before scoring, standardize before ICP tiers), with time estimates and script-versus-manual labeling
- Cleans the database: deletes no-email contacts, suppresses hard bounces, global unsubscribes, and ghost records, merges duplicate companies by domain and fuzzy name, and reassigns deactivated owners
- Enriches records: backfills company name, industry, and geo, fixes lifecycle-stage violations, assigns unowned contacts, and runs external waterfall enrichment through pluggable providers (FullEnrich, Apollo, Hunter, Dropcontact, or your own)
- Builds segmentation and scoring: ICP tier properties, smart lists, and a Fit-plus-Engagement lead-scoring model with decay for HubSpot's post-2025 scoring tool
- Creates automation through the stable v4 Automation API, always disabled for UI review before enabling, plus a workflows-as-code path that exports, diffs, and restores workflows as versioned JSON
- Puts every state-changing skill through a Plan, Before, Execute, After pattern with a required rollback section, abort thresholds, CSV baselines, and explicit confirmation
- Verifies itself with /sandbox-self-test against a free disposable developer test account, seeding fixtures and tearing them down, with production hard-locked in code
What it can’t do
- Run itself hands-off; every skill executes Python in your environment, so setup, token scopes, and reading the source stay on you
- Work without a HubSpot private app token and the right scopes in .env; the workflow skills also need a Marketing Professional plan or higher
- Replace an enrichment budget; waterfall-enrich-contacts needs your own provider API key and spends real credits per lookup
- Undo a HubSpot change automatically beyond what each skill's rollback section covers; deletes and merges are as permanent as HubSpot makes them
- Lean on a large community or fast support; at 67 stars with one maintainer, you are close to the source when something breaks
- Stay current with HubSpot's newest API on its own; scripts target the stable v3 and v4 versions supported through March 2027, with the date-based 2026-03 target deferred to a future major version
Pros & cons
Pros
- Broadest HubSpot-admin coverage in one MIT pack: 37 skills across audit, hygiene, enrichment, scoring, automation, and ongoing maintenance
- Careful safety model for its size, with Plan, Before, Execute, After plus rollback, abort thresholds, CSV audit trails, and required confirmation before any write
- Production-locked sandbox self-test that proves the toolkit on a disposable portal before real data, with the account-type gate failing closed and no override
- Built by a working HubSpot practitioner (Tom Granot of SyntaxGTM), so the audit logic reflects real enterprise portal problems
- Free on top of a Claude Code subscription, against the manual hours of a HubSpot admin or the fees of an ops consultant
- Uses the stable v4 Automation API to create workflows disabled-for-review, and adds a workflow backup-and-restore path HubSpot itself lacks
Cons
- Young and small: 67 stars, 18 forks, and no code push since July 2026, so it is early and lightly battle-tested
- Solo-maintained, with Claude Code co-authoring most commits, so bus factor and support rest on one person
- Executes Python with contact, company, and deal write and delete scopes against your live CRM, so a misconfigured run has real blast radius
- Full enrichment value needs your own paid provider account, and the workflow skills need a Marketing Professional plan or higher
- Community feedback is essentially absent; there are no independent reviews or user threads to cross-check against yet
- No substitute for HubSpot Operations Hub's native dedupe and data-quality tooling; it sits alongside the platform, not above it
7 sourcesWhere this page’s facts came from. Open the receipts.
- 1GitHub repo (TomGranot/hubspot-admin-skills)
- 2GitHub API, repo metadata (stars, forks, license, language, created and pushed dates)
- 3GitHub API, recent commits (activity and recency, last push 2026-07-12)
- 4README (37 skills, install, connection paths, safety pattern, prerequisites, API versioning)
- 5Project homepage with per-skill docs and the walkthrough video
- 6YouTube, maintainer demo of the toolkit (SyntaxGTM / Tom Granot)
- 7SyntaxGTM, Tom Granot's technical GTM channel and consultancy (maintainer background)
Watch it work
Real tutorials and reviews from YouTube, not ours.