# HubSpot Auditor

> HubSpot Auditor is an open-source MCP server for sales and crm. Read-only HubSpot portal audit with a scored report and a 30/60/90-day fix plan. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/m-pineapple/hubspot-auditor
- **MCP Registry name:** io.github.M-Pineapple/hubspot-auditor
- **Categories:** [sales and CRM](https://ai-powered.com/categories/sales-and-crm), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add hubspot-auditor --env HUBSPOT_ACCESS_TOKEN='<HUBSPOT_ACCESS_TOKEN>' -- npx -y hubspot-auditor
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "hubspot-auditor": {
      "command": "npx",
      "args": [
        "-y",
        "hubspot-auditor"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hubspot-auditor": {
      "command": "npx",
      "args": [
        "-y",
        "hubspot-auditor"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hubspot-auditor": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hubspot-auditor"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hubspot-auditor": {
      "command": "npx",
      "args": [
        "-y",
        "hubspot-auditor"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hubspot-auditor": {
      "command": "npx",
      "args": [
        "-y",
        "hubspot-auditor"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "<HUBSPOT_ACCESS_TOKEN>"
      }
    }
  }
}
```

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

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Maildignity](https://ai-powered.com/mcp/maildignity-2): Maildignity is a freemium MCP server for sales and crm.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/hubspot-auditor
