# MCP server scopes not getting added. **URL:** \ **Category:** APIs & Integrations\ **Tags:** professional\ **Created:** [October 24, 2025, 2:40pm UTC](https://community.hubspot.com/t/mcp-server-scopes-not-getting-added/141572 "2025-10-24T14:40:54Z")\ **Posts on this page:** 5\ **Page:** 1
**Author:** ![RM80](https://avatars.discourse-cdn.com/v4/letter/r/96bed5/32.png) [@RM80](https://community.hubspot.com/u/RM80)\ **Post date:** [October 24, 2025, 2:40pm UTC](https://community.hubspot.com/t/mcp-server-scopes-not-getting-added/141572/1 "2025-10-24T14:40:54Z")
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 ? ![Screenshot 2025-10-24 at 8.01.17 PM.png](https://d2qpr2jzcazej7.cloudfront.net/original/3X/8/a/8a06b1c81b53f99f0516ed7657798f6d47834f7d.png) ---
**Author:** ![chighsmith](https://avatars.discourse-cdn.com/v4/letter/c/77aa72/32.png) [@chighsmith](https://community.hubspot.com/u/chighsmith)\ **Post date:** [October 24, 2025, 2:59pm UTC](https://community.hubspot.com/t/mcp-server-scopes-not-getting-added/141572/2 "2025-10-24T14:59:45Z")
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 ---
**Author:** ![jpsanchez](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/jpsanchez/32/106486_2.png) [@jpsanchez](https://community.hubspot.com/u/jpsanchez)\ **Post date:** [October 25, 2025, 4:04pm UTC](https://community.hubspot.com/t/mcp-server-scopes-not-getting-added/141572/3 "2025-10-25T16:04:29Z")
## 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:`** 1. **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 ✅ `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:​** 1. **Required scopes: Must be authorized for installation** 2. **Conditionally required: Required only if present in install URL (enables tiered access)** 3. **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 ❌ 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 **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.​** **Your three options:** 1. Accept CRM-only limitation with official MCP 2. Use CalypsoCodex Extended for better CRM coverage 3. Build custom MCP server with Marketing API integration **Documentation sources:** - Official MCP Integration: [Integrate AI tools with the HubSpot MCP server - HubSpot docs](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-hubspot-mcp-server) - MCP Server Overview: [HubSpot MCP Server](https://developers.hubspot.com/mcp) - OAuth Scopes Reference: [Scopes - HubSpot docs](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/scopes) - CalypsoCodex Extended: [GitHub - calypsoCodex/hubspot-mcp-extended: Independent MCP server implementation using HubSpot's official OpenAPI specs. 106 comprehensive tools for CRM automation including invoices and line items. Source Available - Free for non-commercial use. · GitHub](https://github.com/calypsoCodex/hubspot-mcp-extended) **``** ---
**Author:** ![suprdense](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/suprdense/32/6496_2.png) [@suprdense](https://community.hubspot.com/u/suprdense)\ **Post date:** [October 27, 2025, 8:07am UTC](https://community.hubspot.com/t/mcp-server-scopes-not-getting-added/141572/4 "2025-10-27T08:07:30Z")
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](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-hubspot-mcp-server). ---
**Author:** ![jpsanchez](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/jpsanchez/32/106486_2.png) [@jpsanchez](https://community.hubspot.com/u/jpsanchez)\ **Post date:** [October 27, 2025, 10:23am UTC](https://community.hubspot.com/t/mcp-server-scopes-not-getting-added/141572/5 "2025-10-27T10:23:29Z")
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: [GitHub - calypsoCodex/hubspot-mcp-extended: Independent MCP server implementation using HubSpot's official OpenAPI specs. 106 comprehensive tools for CRM automation including invoices and line items. Source Available - Free for non-commercial use. · GitHub](https://github.com/calypsoCodex/hubspot-mcp-extended)