Skip to content
MCP server

HubSpot Auditor

Read-only HubSpot portal audit with a scored report and a 30/60/90-day fix plan

Runs locallyStatus and history
Install
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-auditor

Add 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.

How AIPoweredBot checks servers