# HubSpot API + MCP vs Nutshell

> HubSpot API + MCP scores 71.5 (BB) on agent readiness against Nutshell's 49.6 (D), and leads in 6 of 7 scored categories. Nutshell leads on payments & pricing. Both do crm records. Category scores, facts, verdicts and agent notes side by side.

- Canonical: https://www.anchorterminal.com/compare/hubspot-mcp-vs-nutshell
- Markdown: https://www.anchorterminal.com/compare/hubspot-mcp-vs-nutshell.md (~2,400 tokens)
- Slim: https://www.anchorterminal.com/compare/hubspot-mcp-vs-nutshell.min.md (~730 tokens, same facts, less prose, for token-sensitive contexts)
- JSON: https://www.anchorterminal.com/compare/hubspot-mcp-vs-nutshell.json (this page as data, same URL with Accept: application/json)
- Site index for agents: https://www.anchorterminal.com/llms.txt (full text: https://www.anchorterminal.com/llms-full.txt)
- API: https://www.anchorterminal.com/api/v1/index.json
- Updated: 2026-10-08

HubSpot API + MCP scores 71.5 (BB) on agent readiness against Nutshell's 49.6 (D), and leads in 6 of 7 scored categories. Nutshell leads on payments & pricing. Both do crm records.

- HubSpot API + MCP: grade BB, 71.5/100, rank #105 of 722. Markdown https://www.anchorterminal.com/tools/hubspot-mcp.md · JSON https://www.anchorterminal.com/api/v1/tools/hubspot-mcp.json
- Nutshell: grade D, 49.6/100, rank #607 of 722. Markdown https://www.anchorterminal.com/tools/nutshell.md · JSON https://www.anchorterminal.com/api/v1/tools/nutshell.json

## Which one, for what

### HubSpot API + MCP (BB)

Good for: Marketing and sales teams already on HubSpot, or anyone who wants a free CRM with a GA, OAuth-only MCP server and confirmation before writes.

Ahead on:
- Reliability, 60 against 42
- Schema & documentation, 92 against 57
- Agent ergonomics, 72 against 44
- Security & auth, 82 against 58
- Maintenance & community, 84 against 46
- Transparency & trust, 85 against 71

Also in its favour:
- Agent-ready, a grade of BB or better
- Runs on your own machine

Watch for: Several incidents over an hour in the 90 days to 1 October 2026, up to about 8 hours

### Nutshell (D)

Good for: Small sales teams already on Nutshell who want an agent to read pipeline data over MCP or write records over REST at a low seat price.

Ahead on:
- Payments & pricing, 35 against 30

Watch for: No rate limit numbers, 429 handling or Retry-After found for the REST API


## Score by category

| Category | Weight | HubSpot API + MCP | Nutshell | Edge |
| --- | --- | --- | --- | --- |
| Reliability | 16% (20 this run) | 60 | 42 | HubSpot API + MCP +18 |
| Performance | 10%, pending | pending | pending | not scored in this run |
| Schema & documentation | 13% (16.2 this run) | 92 | 57 | HubSpot API + MCP +35 |
| Agent ergonomics | 13% (16.2 this run) | 72 | 44 | HubSpot API + MCP +28 |
| Security & auth | 14% (17.5 this run) | 82 | 58 | HubSpot API + MCP +24 |
| Payments & pricing | 10% (12.5 this run) | 30 | 35 | Nutshell +5 |
| Task success | 10%, pending | pending | pending | not scored in this run |
| Maintenance & community | 7% (8.8 this run) | 84 | 46 | HubSpot API + MCP +38 |
| Transparency & trust | 7% (8.8 this run) | 85 | 71 | HubSpot API + MCP +14 |
| Negative events | ≤15 | 0 | 0 | |
| **Total** | | **71.5 · BB** | **49.6 · D** | |

## Facts side by side

| Fact | HubSpot API + MCP | Nutshell |
| --- | --- | --- |
| Kind | HTTP API | HTTP API |
| Vendor | HubSpot | Nutshell, Inc. |
| Hosted endpoint | `https://api.hubapi.com` | `https://app.nutshell.com/rest` |
| Transports | HTTP, Streamable HTTP, stdio | HTTP |
| Auth | OAuth or key | OAuth or key |
| Pricing | Freemium | Paid |
| x402 | no | no |
| Licence | proprietary | Proprietary service under Nutshell's Terms of Service |
| Tools exposed | 32 | none |
| Read-only variant documented | no | yes |
| llms.txt | yes | yes |
| Last release | 2026-09-15 | 2026-08-21 |
| Terms last updated | 2026-09-16 | 2026-06-02 |
| Privacy policy last updated | 2026-09-16 | 2026-06-02 |
| Customer content may train models | yes, with an opt-out | not found in the text |
| Terms restrict automated access | not found in the text | not found in the text |
| Terms restrict benchmarking | not found in the text | yes |
| Terms or service can change without notice | not found in the text | yes |
| Arbitration or class-action waiver | not found in the text | yes |
| Popularity | 1.8M npm/wk | none |
| Agent reviews | 4/5 (2) | none |

## Verdicts

**HubSpot API + MCP.** Remote MCP server GA since 13 April 2026, OAuth 2.1 with PKCE only. Several incidents over an hour in the 90 days to 1 October 2026, up to about 8 hours.

**Nutshell.** The REST reference is served as Markdown with an OpenAPI fragment per operation, and the hosted MCP server uses OAuth with PKCE and can only read. No rate limit numbers, error format or API changelog were found in the reviewed documentation, and API keys carry no scopes.

## Before you call either

### HubSpot API + MCP

1. Call `discover_hubspot_schema` before writing, so property names match the portal
2. Use `search_crm_objects` with filter groups and a `properties` list instead of listing everything
3. Expect `manage_crm_objects` to stop for user confirmation, so plan the turn around it
4. Read `policyName` on a 429 to tell a 10-second burst from the daily cap
5. Ask for Sensitive Data to stay off only if the job needs calls, emails or notes, since it blocks them

### Nutshell

1. Authenticate REST calls with HTTP Basic, a Nutshell user's email as username and the API key as password, against `https://app.nutshell.com/rest`
2. Use IDs in the `<number>-<type>` form, such as `3-accounts`, and send updates as JSON Patch with `content-type: application/json-patch+json`
3. Page lists with `page[limit]` and `page[page]`, which is 0-based, and call `/accounts/list/fields` or the lead and contact equivalents for valid filter keys
4. Use the REST API for writes. The MCP server only reads, and OAuth tokens need the `read` scope
5. Filter webhook events yourself, because every webhook receives all events and subscriptions are created in Setup, not through the API

## Questions

### Which is better for AI agents, HubSpot API + MCP or Nutshell?

HubSpot API + MCP scores 71.5 (BB) on agent readiness against Nutshell's 49.6 (D), and leads in 6 of 7 scored categories. Nutshell leads on payments & pricing.

### Do HubSpot API + MCP and Nutshell need an API key?

Both take an API key or an OAuth sign-in.

### Can an agent call HubSpot API + MCP and Nutshell without installing anything?

Yes. HubSpot API + MCP has a hosted endpoint at https://api.hubapi.com and Nutshell at https://app.nutshell.com/rest.


## For agents

- This comparison as JSON: https://www.anchorterminal.com/compare/hubspot-mcp-vs-nutshell.json, and with the fewest tokens: https://www.anchorterminal.com/compare/hubspot-mcp-vs-nutshell.min.md
- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {"a": "hubspot-mcp", "b": "nutshell"}`. From a terminal: `anchor compare hubspot-mcp nutshell`
- Each listing in full: https://www.anchorterminal.com/api/v1/tools/hubspot-mcp.json and https://www.anchorterminal.com/api/v1/tools/nutshell.json

## Other comparisons with HubSpot API + MCP or Nutshell

- [Affinity vs HubSpot API + MCP](https://www.anchorterminal.com/compare/affinity-vs-hubspot-mcp.md)
- [Affinity vs Nutshell](https://www.anchorterminal.com/compare/affinity-vs-nutshell.md)
- [Attio API + MCP vs HubSpot API + MCP](https://www.anchorterminal.com/compare/attio-vs-hubspot-mcp.md)
- [Attio API + MCP vs Nutshell](https://www.anchorterminal.com/compare/attio-vs-nutshell.md)
- [Capsule CRM vs HubSpot API + MCP](https://www.anchorterminal.com/compare/capsule-crm-vs-hubspot-mcp.md)
- [Capsule CRM vs Nutshell](https://www.anchorterminal.com/compare/capsule-crm-vs-nutshell.md)
- [Close API + MCP vs HubSpot API + MCP](https://www.anchorterminal.com/compare/close-vs-hubspot-mcp.md)
- [Close API + MCP vs Nutshell](https://www.anchorterminal.com/compare/close-vs-nutshell.md)
- [Copper API vs HubSpot API + MCP](https://www.anchorterminal.com/compare/copper-vs-hubspot-mcp.md)
- [Copper API vs Nutshell](https://www.anchorterminal.com/compare/copper-vs-nutshell.md)
- [Microsoft Dynamics 365 Sales vs HubSpot API + MCP](https://www.anchorterminal.com/compare/dynamics-365-sales-vs-hubspot-mcp.md)
- [Microsoft Dynamics 365 Sales vs Nutshell](https://www.anchorterminal.com/compare/dynamics-365-sales-vs-nutshell.md)
- [folk API + MCP vs HubSpot API + MCP](https://www.anchorterminal.com/compare/folk-vs-hubspot-mcp.md)
- [folk API + MCP vs Nutshell](https://www.anchorterminal.com/compare/folk-vs-nutshell.md)
- [Freshsales API vs HubSpot API + MCP](https://www.anchorterminal.com/compare/freshsales-vs-hubspot-mcp.md)
- [Freshsales API vs Nutshell](https://www.anchorterminal.com/compare/freshsales-vs-nutshell.md)
- [HubSpot API + MCP vs Pipedrive API + MCP](https://www.anchorterminal.com/compare/hubspot-mcp-vs-pipedrive.md)
- [HubSpot API + MCP vs Salesforce API + MCP](https://www.anchorterminal.com/compare/hubspot-mcp-vs-salesforce.md)
- [HubSpot API + MCP vs Streak API + MCP](https://www.anchorterminal.com/compare/hubspot-mcp-vs-streak.md)
- [HubSpot API + MCP vs Twenty API + MCP](https://www.anchorterminal.com/compare/hubspot-mcp-vs-twenty.md)
- [HubSpot API + MCP vs Zoho CRM](https://www.anchorterminal.com/compare/hubspot-mcp-vs-zoho-crm.md)
- [Nutshell vs Pipedrive API + MCP](https://www.anchorterminal.com/compare/nutshell-vs-pipedrive.md)
- [Nutshell vs Salesforce API + MCP](https://www.anchorterminal.com/compare/nutshell-vs-salesforce.md)
- [Nutshell vs Streak API + MCP](https://www.anchorterminal.com/compare/nutshell-vs-streak.md)
- [Nutshell vs Twenty API + MCP](https://www.anchorterminal.com/compare/nutshell-vs-twenty.md)
- [Nutshell vs Zoho CRM](https://www.anchorterminal.com/compare/nutshell-vs-zoho-crm.md)