Get started
Install in two commands
Free and open source under MIT.
1. Prerequisites
- Claude Code installed and configured
- A HubSpot account with a private app token — create one under Settings → Integrations → Private Apps, with CRM read/write scopes for the objects you want to manage
- Python 3.10+ with uv for the scripted skills
- HubSpot Marketing Professional or higher for the workflow-building skills
2. Install the plugin
In Claude Code:
/plugin marketplace add tomgranot/hubspot-admin-skills
/plugin install hubspot-admin@hubspot-admin-skillsOr clone directly: git clone https://github.com/TomGranot/hubspot-admin-skills.git
3. Run your first audit
/hubspot-auditThe audit scans your entire portal, grades every finding A–F, and maps each one to the skill that fixes it. Then /hubspot-implementation-plan turns the findings into a phased roadmap.
For AI agents
This entire site is built to be consumed by agents. If you're an agent (or driving one), these are your entry points:
/llms.txt— spec-compliant index of every skill's raw markdown/llms-full.txt— all 37 skills concatenated for single-fetch ingestion/api/skills.json— machine-readable catalog: slugs, categories, script availability, install commands- Every skill page has a raw markdown twin at
/skills/<slug>.mdand raw scripts at/skills/<slug>/scripts/<stage>.py
Copy-paste prompt for your agent
Paste this into Claude Code (or any agent with shell access):
Install the HubSpot Admin Skills plugin and audit my HubSpot portal.
1. Run: /plugin marketplace add tomgranot/hubspot-admin-skills
2. Run: /plugin install hubspot-admin@hubspot-admin-skills
3. I'll provide a HubSpot private app token as HUBSPOT_ACCESS_TOKEN (in .env).
4. Run /hubspot-audit and walk me through the findings.
Skill catalog (machine-readable): https://hubspot.granot.io/api/skills.json
Full skill documentation: https://hubspot.granot.io/llms-full.txtA note on safety
Several skills modify or delete CRM records. Every destructive skill exports a CSV baseline first, shows what will change, and asks before writing. Want proof before granting a production token? Run /sandbox-self-test against a free HubSpot developer test account: it seeds fixtures, runs the toolkit end to end, grades the results, and refuses to touch anything that is not a sandbox.