HubSpot Auditor
Read-only HubSpot portal audit with a scored report and a 30/60/90-day fix plan
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 1.5.3
- Listing updated
- today
Similar MCP servers
About HubSpot Auditor
HubSpot Auditor is an open-source MCP server for sales and crm. It runs locally on your machine and is started by your AI client.
HubSpot Auditor reviews a portal without changing it and returns a score based on the percentage of checks that pass. Each check lands as working, broken, missing or needing operator confirmation, with severity, evidence and a recommended fix. Evidence is counts and property names, and the report does not print contact records.
The rule set is versioned YAML you can switch off or retune, covering CRM hygiene, pipelines, forms, tracking, email authentication (SPF, DKIM, DMARC), integrations, reporting, brand and landing pages, buyer journeys and program setup. Findings are ranked by the business process they affect, such as billing or territory, ahead of lower-impact items, and each plan item names an owner role and a retest.
It sends only GET requests to HubSpot apart from a start-up read of the token's scopes, and warns if the token has write scopes. A demo mode runs on a fictional portal with no token. It requires Node.js 22 or newer and offers a CLI as well as the MCP server.
Install
Run in a terminal
claude mcp add hubspot-auditor --env HUBSPOT_ACCESS_TOKEN='<HUBSPOT_ACCESS_TOKEN>' -- npx -y hubspot-auditorAdd to claude_desktop_config.json
{
"mcpServers": {
"hubspot-auditor": {
"command": "npx",
"args": [
"-y",
"hubspot-auditor"
],
"env": {
"HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"hubspot-auditor": {
"command": "npx",
"args": [
"-y",
"hubspot-auditor"
],
"env": {
"HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"hubspot-auditor": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hubspot-auditor"
],
"env": {
"HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"hubspot-auditor": {
"command": "npx",
"args": [
"-y",
"hubspot-auditor"
],
"env": {
"HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"hubspot-auditor": {
"command": "npx",
"args": [
"-y",
"hubspot-auditor"
],
"env": {
"HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
HUBSPOT_ACCESS_TOKENRead-only HubSpot private app token. Not needed for demo mode.
What it does
- Read-only by design
- Requests are held to an allowlist and no PUT, PATCH or DELETE is sent.
- Scored report
- Score is the share of checks that are working.
- 30/60/90-day plan
- Fixes sorted by severity with an owner role and retest.
- Configurable rules
- Versioned YAML with enabled flags and thresholds.
- Demo mode
- Runs against a fictional portal without a token.
- Markdown and JSON reports
- Regenerate reports after changing thresholds.
Good for
- Clean a portal before a process change
- Check GDPR consent and email sender authentication
- Hand a client a prioritised checklist
- Find forms with no captcha or honeypot
- Spot weak deal stage probabilities
Pricing
Open source
HubSpot Auditor FAQ
Can it change my HubSpot data?
No. It uses allowlisted read requests and warns if the token has a write scope.
Do I need a HubSpot token to try it?
No. Demo mode uses a fictional portal.
What does the score mean?
The percentage of checks that are working; checks needing operator confirmation do not count as passes.
What does it need to run?
Node.js 22 or newer, and a read-only private app token for live mode.
Is HubSpot Auditor free?
Yes. HubSpot Auditor is open source, so you can use and self-host it for free.
How do I add HubSpot Auditor to Claude Code?
Run this command in your terminal: claude mcp add hubspot-auditor --env HUBSPOT_ACCESS_TOKEN='<HUBSPOT_ACCESS_TOKEN>' -- npx -y hubspot-auditor
What are the best alternatives to HubSpot Auditor?
The closest alternatives to HubSpot Auditor are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Tapetide - Indian Stock Market MCP and World Monitor.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

