MCP server scopes not getting added.

RM80 — Fri, 24 Oct 2025 14:40:54 GMT

I have now finally created the app that can conenct to the hubspot mcp server. now i am trying to add scopes but it is not letting me add. getting this error. any solution for this ?

Re: MCP server scopes not getting added.

chighsmith — Fri, 24 Oct 2025 14:59:45 GMT

Hi @RM80,

Thank you for posting to the Community!

I'd like to tag in some of our Top Contributors to see if they have experienced this error before -- Hi @jpsanchez and @suprdense Have either of you seen this before? If so, how did you resolve?

Thank you!

Cassie, Community Manager

Re: MCP server scopes not getting added.

jpsanchez — Sat, 25 Oct 2025 16:05:37 GMT

Quick Answer: Marketing Campaign Scopes Are NOT Supported

The error you're experiencing is likely because you're trying to add marketing campaign scopes to an MCP app, which fundamentally doesn't support them. The HubSpot MCP server architecture is built exclusively on the CRM Search API, which has no access to Marketing Hub objects.

Neither implementation supports marketing.campaigns scopes:

HubSpot Official MCP Server: Limited to CRM objects only with read-only access

CalypsoCodex MCP Extended: Covers 106 CRM tools but no marketing campaign functionality

Understanding Your Scope Error

When you receive an error adding scopes to your HubSpot MCP server app, it's typically due to one of these issues:

1. User-Level vs Account-Level Installation

The official HubSpot MCP server requires user-level OAuth installation, not the traditional account-wide app installation:

json

{ "isUserLevel": true, "distribution": "marketplace" }

Critical difference:

Traditional apps: Account-wide installation with admin-controlled scopes
MCP apps: Each user installs individually, scopes governed by user permissions AND app configuration

2. Scope Availability Restrictions

Your error likely occurs because you're trying to add scopes that are:

Not supported by MCP server:
- ❌ marketing.campaigns.read
- ❌ marketing.campaigns.write
- ❌ marketing.campaigns.revenue.read
- ❌ Any Marketing Hub, Service Hub, or CMS Hub scopes beyond CRM
  
  Supported CRM scopes (read-only):
  - ✅ crm.objects.contacts.read
  - ✅ crm.objects.companies.read
  - ✅ crm.objects.deals.read
  - ✅ crm.objects.tickets.read
  - ✅ crm.objects.invoices.read
  - ✅ crm.objects.quotes.read
  - ✅ crm.objects.products.read
  - ✅ crm.objects.line_items.read
  - ✅ crm.objects.orders.read
  - ✅ crm.objects.carts.read
  - ✅ crm.objects.subscriptions.read
  - ✅ crm.objects.users.read

✅ crm.objects.owners.read

3. Developer Platform Version Requirement

Ensure your app is built on Developer Platform version 2025.2 or higher:

json

{ "platformVersion": "2025.2" }

Apps on older platform versions cannot connect to the MCP server.

Solution Paths

Option A: Work Within MCP Limitations

If you need CRM data only, configure your app with supported scopes:

In your app-hsmeta.json:

json

{ "name": "Your MCP App", "platformVersion": "2025.2", "isUserLevel": true, "distribution": "marketplace", "requiredScopes": [ "oauth", "crm.objects.contacts.read", "crm.objects.companies.read", "crm.objects.deals.read" ], "optionalScopes": [ "crm.objects.tickets.read", "crm.objects.invoices.read" ] }

Scope configuration types:

Required scopes: Must be authorized for installation
Conditionally required: Required only if present in install URL (enables tiered access)
Optional scopes: Not required; authorized if available

Option B: Use CalypsoCodex MCP Extended

If you need more CRM functionality (106 tools vs. HubSpot's basic coverage), use the community implementation:

What it provides:
- 106 comprehensive CRM tools (vs. official server's limited toolset)
- Full CRUD operations for invoices, line items, quotes
- Batch operations and advanced search
- Works with Private Apps or Connected Apps
- Does NOT require user-level installation
  
  What it still lacks:
  - ❌ Marketing campaigns
  - ❌ Marketing emails
  - ❌ Service Hub objects

❌ CMS content

Installation:

bash

git clone https://github.com/calypsoCodex/hubspot-mcp-extended.git cd hubspot-mcp-extended cp .env.example .env # Add your HUBSPOT_ACCESS_TOKEN to .env ./deploy-local.sh

Key Takeaway

Your three options:

Accept CRM-only limitation with official MCP
Use CalypsoCodex Extended for better CRM coverage
Build custom MCP server with Marketing API integration

Documentation sources:
- Official MCP Integration: https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-hubspot-mcp-server
- MCP Server Overview: https://developers.hubspot.com/mcp
- OAuth Scopes Reference: https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/scopes
- CalypsoCodex Extended: https://github.com/calypsoCodex/hubspot-mcp-extended

Re: MCP server scopes not getting added.

suprdense — Mon, 27 Oct 2025 08:07:30 GMT

Perfect answer by @jpsanchez

Just know that the MCP server is still in its nacscent stages and has limitations in terms of what scopes have been provisioned for it.

You can find the scopes supported for the MCP server HERE.

Re: MCP server scopes not getting added.

jpsanchez — Mon, 27 Oct 2025 10:23:29 GMT

Thanks so much, @suprdense. If you’re interested, I put together a small MCP project you might like: CalypsoCodex Extended — an independent implementation with 106 CRM tools built from HubSpot’s official OpenAPI specs. Source-available (free for non‑commercial use). CalypsoCodex Extended: https://github.com/calypsoCodex/hubspot-mcp-extended

topic Re: MCP server scopes not getting added. in APIs & Integrations

MCP server scopes not getting added.

Re: MCP server scopes not getting added.

Re: MCP server scopes not getting added.

Quick Answer: Marketing Campaign Scopes Are NOT Supported

Understanding Your Scope Error

1. User-Level vs Account-Level Installation

2. Scope Availability Restrictions

3. Developer Platform Version Requirement

Solution Paths

Option A: Work Within MCP Limitations

Option B: Use CalypsoCodex MCP Extended

Key Takeaway

Re: MCP server scopes not getting added.

Re: MCP server scopes not getting added.