HubSpot Admin Skills plugin
40 Claude Code skills for auditing, cleaning and automating HubSpot CRM, from a portal audit report to removing junk contacts.
- 81 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Scripts read and change CRM data, including deleting contacts, and the HubSpot key sits in `.env`.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/hubspot-admin-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Scripts read and change CRM data, including deleting contacts, and the HubSpot key sits in `.env`.
This is third-party code. Review the repository files before installing.
What it does
The plugin walks a HubSpot admin through a five-step cycle. First `/hubspot-audit`, `/hubspot-marketing-audit` and `/hubspot-sales-audit` run a read-only portal audit and grade it, and `/hubspot-implementation-plan` builds a phased fix plan. Then skills follow a plan, before, execute, after pattern: they explain the approach, export a CSV baseline, make the changes and verify the result. Python scripts (`requests`, run with `uv run`) call the HubSpot REST API with a service key from `HUBSPOT_ACCESS_TOKEN`. Skills cover duplicates, contacts with no email, lifecycle stages, lists and workflows, while `/weekly-cleanup-routine` and `/quarterly-database-cleanup` keep things tidy. HubSpot remote MCP server for lookups and Agent CLI for bulk work connect optionally.
Who it is for. HubSpot admins and marketing and sales ops managers who bring order to the database of contacts, deals and workflows.
Good fit when
- Before cleanup an audit with grades and a prioritized list of skills to run is needed.
- Contacts with no email are deleted after a CSV export and a review of the list.
- Workflows are created through the API disabled so they can be reviewed in the UI.
- A routine database cleanup runs weekly in five minutes.
Not a fit when
- You work in another CRM, since the skills are written for the HubSpot API.
- You have no service key with the needed scopes.
- You would try deletion on live data with no sandbox.
Example request
Run a full read-only audit of my HubSpot portal, show a prioritized list of problems and build a fix plan.Limitations
Claude Code, a HubSpot account with a service key (Settings, Integrations, Service Keys; a token from an old private app also works) and Python 3.10 or newer with `uv` are required. The set of scopes depends on the skill. The skills change and delete portal records, so try deletion and bulk edits first on a developer test account: `/sandbox-self-test` exists for this and locks out production. Workflows created through the API start disabled. API rate limits depend on the plan, and the HubSpot Workflows API is still in beta. Skills that need the UI give step-by-step instructions rather than scripts.
How to disable. Run `/plugin uninstall hubspot-admin@hubspot-admin-skills` and remove the source from your marketplaces. Delete `HUBSPOT_ACCESS_TOKEN` from `.env` and revoke the service key in HubSpot settings.
FAQ
Where do I start?
With `/hubspot-audit`: it runs a read-only portal audit and names the skill that fixes each finding. Then `/hubspot-implementation-plan` builds a plan by order and dependencies.
Which connection path should I pick?
Service key scripts by default. The HubSpot remote MCP suits conversational lookups but cannot delete records. The Agent CLI in beta takes bulk writes and deletes.
Can the skills be tested without a live portal?
Yes. `/sandbox-self-test` runs the toolkit on a free developer test account with synthetic data and cleans up. It does not run against production.
Are private apps needed?
No, HubSpot stops creating legacy private apps on 26 October 2026, so the skills ask for a service key. An existing app token keeps working.
How do I keep things tidy?
Run `/weekly-cleanup-routine` weekly and `/quarterly-database-cleanup` quarterly. The audit tells you when it finds a problem with no ready skill.
Discussion
No questions or reviews yet.
Related
Plugins45 B2B revenue operations skills: strategy, diagnostics, metrics, GTM, ICP, positioning, deal velocity and operating cadence.
211 skills for sales, marketing and RevOps: buyer research, outbound, SEO, ABM and analytics with a result check.
116 skills for an agent working a Shopify store through the Admin API, plus scheduled routines: stock, returns, finance, SEO
GTM Skills by Explorium
GTM Skills
22 skills for B2B sales: company lists, contact enrichment, lead scoring and cold email, built on Vibe Prospecting MCP data
Two Claude Code plugins: 10 marketing skills and 9 sales skills with ready-made methods and frameworks.
Two LinkedIn skills via Linked API: people and company search, messages, posts and a lead pipeline with connection invites.
README in short
The README covers the 2.0, 1.2 and 1.1 release news, three ways to connect to HubSpot, installation, a five-step workflow, a reference of 40 skills with descriptions, requirements and the repository layout.