HubSpot MCP Server: Setup, OAuth & CRM Access

REMOTE MCP SERVER

HubSpot MCP Server: Setup, OAuth & CRM Access

The remote HubSpot MCP server is HubSpot-hosted and available at https://mcp.hubspot.com. It uses OAuth 2.1 with PKCE and lets compatible MCP clients work with supported HubSpot CRM context and actions without requiring a team to operate its own MCP server.

This is most useful when an AI assistant needs live CRM context across contacts, companies, deals, tickets or related activity and the team wants permissions to follow the connected HubSpot user. It can shorten the path from a question to a CRM-informed answer or action without turning every workflow into a custom API project.

Remote MCP is different from HubSpot Developer MCP. Use the remote server for business-facing CRM workflows; use Developer MCP for app, CMS and development tasks inside coding environments.

HubSpot 14-Day Free TrialTry HubSpot premium marketing and CRM workflows free for 14 daysNo credit card or commitment required.
Start Your Free 14-Day HubSpot Trial →

Interactive decision tool

HubSpot AI Connection Planner

Choose the AI environment, task and control level. The tool recommends the most suitable HubSpot connection path and generates a safe starter prompt. It never asks for an API key, OAuth token or HubSpot password.

HubSpot 14-Day Free TrialTry HubSpot premium marketing and CRM workflows free for 14 daysNo credit card or commitment required.
Start Your Free 14-Day HubSpot Trial →

Quick answer

The best HubSpot AI connection depends on where the work starts

The remote HubSpot MCP server is HubSpot-hosted, uses OAuth 2.1 with PKCE, and can expose supported CRM data and actions to compatible MCP clients. Use the hosted server when the client supports managed OAuth and the goal is CRM context or CRM action rather than local HubSpot app development.

The main constraint is that incorrect scopes, stale authorizations or over-broad access can create confusing failures or unnecessary data exposure. Build the first workflow around a small, measurable problem so the team can learn what the tool does well before increasing access, spend or prompt coverage.

A sensible starting point is to create the MCP auth app, connect the client to the hosted endpoint, inspect available tools and user permissions, then test one controlled workflow before expanding. Judge the result using successful authentication, available object coverage, write-action success rate, audit-log visibility and reduction in custom integration code rather than relying on how impressive the interface feels during setup.

MCP Server capability map

For teams using the hosted MCP server, the exact path matters because HubSpot offers direct AI connectors, a remote MCP server and a separate developer MCP server.

MCP Server capability map
PathBest forWrite actionsImportant requirement
ChatGPT connectorEveryday CRM analysis and actionsSupported for selected CRM recordsHubSpot access plus an OpenAI account
Claude connectorAnalysis, visualization and CRM actionsSupported for selected CRM recordsHubSpot access plus paid Claude plan
Gemini connectorGoogle Workspace-centered contextFeature set is still evolvingEligible Google Workspace plan; public beta
Copilot agentMicrosoft 365 CRM contextUse supported actions back in HubSpotMicrosoft 365 Copilot environment
Remote MCPCustom MCP clients and agentsSupported on approved objects/toolsOAuth 2.1 with PKCE and MCP Auth App
Developer MCPApps, CMS and developer workflowsDevelopment actions, not normal CRM operationsLocal developer setup

HubSpot AI connection map

Direct connectors, remote MCP and Developer MCP

Use the connection that matches where people work and whether the job is CRM operations or HubSpot development.

Remote MCPGenerally available
  • https://mcp.hubspot.com
  • OAuth 2.1 with PKCE
  • Permission-aware CRM access
ChatGPT / ClaudeCRM actions
  • Read HubSpot context
  • Create and update supported records
  • Review important changes before saving
Gemini / CopilotWorkplace AI
  • Gemini: Public beta
  • Copilot: Available
  • Use existing HubSpot permissions
Developer MCPGenerally available
  • Apps and CMS development
  • Serverless and troubleshooting
  • Local development workflow

What affects the recommendation

Permission fit

The connection should inherit the minimum HubSpot access the user needs for the workflow.

Write controls

Require review for important updates until the team has evidence that the workflow is reliable.

Client fit

Choose the AI environment users already work in unless a custom MCP architecture creates a clear advantage.

Process fit

Keep deterministic, high-volume business logic in APIs or HubSpot automation when conversational interpretation is unnecessary.

What the connection changes in daily CRM work

The remote HubSpot MCP server is HubSpot-hosted, uses OAuth 2.1 with PKCE, and can expose supported CRM data and actions to compatible MCP clients. For admins and developers evaluating the hosted HubSpot MCP endpoint, that matters because the useful part is not simply getting another AI window; it is reducing the distance between a question, the business context behind it, and the next action.

The practical value appears when the workflow is repeatable enough that people stop rebuilding context by hand.

A good MCP Server deployment begins with a narrow business problem rather than a technology demo. Teams should name the records, questions and decisions involved, then decide what the AI is allowed to inspect and what it is allowed to change. That discipline makes the result easier to trust and much easier to evaluate.

The important buying question around MCP Server is whether it changes the operating workflow. A feature can look impressive in a demonstration and still create little value if users must double-check every answer, re-enter the same context elsewhere, or cannot connect the result to an action that matters.

Choose the right HubSpot AI connection path

Use the hosted server when the client supports managed OAuth and the goal is CRM context or CRM action rather than local HubSpot app development. That choice becomes clearer when the team separates conversational analysis from production integration. The best option is usually the one that fits existing tools, user permissions and the level of control the organization needs rather than the option with the longest feature list.

For MCP Server, start by mapping the people who will use it and the systems they already spend time in. A sales rep, RevOps analyst, marketer and developer can all need HubSpot context, but they do not need the same interface, permissions or degree of automation. One connection strategy rarely fits every role equally well.

A useful decision framework asks four questions: where the work starts, what HubSpot information is needed, whether a record must change, and how much human approval should remain. Once those questions are explicit, MCP Server can be judged against alternatives on workflow fit instead of brand preference.

Authentication, permissions and data boundaries

The security model matters because incorrect scopes, stale authorizations or over-broad access can create confusing failures or unnecessary data exposure. Permissions should mirror the user’s real HubSpot responsibilities, and sensitive workflows should avoid broad access simply for convenience. The goal is enough context to do the job while keeping the blast radius of a mistaken prompt or misunderstood instruction appropriately small.

Authentication is only the first control. Teams should also define who can connect, who can approve write actions, which objects matter, and how changed records will be reviewed. With MCP Server, the most dependable operating model is one where access follows existing HubSpot permissions instead of creating an informal second permission system.

For teams using the hosted MCP server, data boundaries deserve special attention when assistants are used across customer records, engagement history or marketing information. Users should understand which data types are available in the selected connection and which are not. That prevents a false assumption that every HubSpot object, custom field or sensitive property behaves the same way.

A practical setup sequence that reduces risk

A low-risk implementation follows a simple progression: create the MCP auth app, connect the client to the hosted endpoint, inspect available tools and user permissions, then test one controlled workflow before expanding. This sequence creates useful evidence before the team broadens access. It also makes troubleshooting easier because authentication, retrieval, prompt quality and write behavior are tested separately rather than being introduced all at once.

Teams often save time by preparing a small acceptance checklist for MCP Server. The checklist can include the expected record, expected fields, acceptable response time, required approval and the exact action that should occur. A five-minute test with a known record can expose configuration problems before a larger workflow touches production data.

Keep the first use case deliberately boring. A repeatable lookup, summary or single-record update teaches more about reliability than an ambitious multi-step agent on day one. Once MCP Server behaves predictably on ordinary work, the team can add larger tasks with a clearer understanding of where human judgment is still needed.

Read workflows before write workflows

Read-first workflows are the easiest place to build confidence with MCP Server. Asking for deal summaries, ticket patterns, account context or campaign performance can deliver immediate value without changing CRM state. Users learn how the connection interprets HubSpot structure while managers can observe whether the answers are accurate enough for real decisions.

For teams using the hosted MCP server, write capability should be added where it eliminates obvious repetitive work, not simply because it exists. Updating a record, logging an activity or creating a follow-up can be valuable when the proposed change is visible and attributable. High-volume or irreversible processes deserve more deterministic controls than an open-ended conversational instruction.

The strongest workflow separates analysis from commitment. Let MCP Server gather and organize context first, then present the proposed action in a way the user can inspect. That keeps speed without turning convenience into silent automation, and it creates a natural checkpoint for correcting bad assumptions before they reach customer-facing records.

Prompts that produce useful CRM outcomes

Prompts work better when they contain a business objective, a HubSpot object or segment, a time frame and the desired output format. For MCP Server, 'show deals that need attention' is weaker than a request that defines stage, close-date window, deal size and the reason the list will be used. Specificity reduces interpretation work.

For teams using the hosted MCP server, reusable prompt patterns should reflect the organization’s actual sales and service language. Include pipeline names, lifecycle stages, ticket priorities, campaign names or other stable concepts that users already understand. The more the prompt resembles the operating vocabulary inside HubSpot, the easier it is to judge whether the resulting answer is genuinely useful.

A prompt library becomes more valuable when each example is tied to an outcome rather than a clever instruction. Good entries for MCP Server might accelerate weekly pipeline review, surface overdue follow-ups, summarize account activity or prepare a customer handoff. The prompt earns a place in the library only if it changes the work that follows.

Where automation can create avoidable mistakes

The most common failure mode is trying to automate a process that the team has not defined clearly. Incorrect scopes, stale authorizations or over-broad access can create confusing failures or unnecessary data exposure. If ownership, data quality or approval rules are already inconsistent, an AI connection can reproduce that inconsistency faster. Fix the process boundary before increasing automation depth.

Another mistake is treating fluent output as evidence of correct CRM interpretation. Users should spot-check important answers against known HubSpot records, especially early in adoption. The test is not whether MCP Server sounds confident; the test is whether it selected the right records, respected the right time frame and proposed the right action.

Avoid turning every workflow into a connector workflow. Some recurring jobs belong in HubSpot automation, custom code or an API integration because they must run predictably without conversational interpretation. MCP Server is strongest when human questions and judgment are part of the process, not when it replaces every deterministic system.

How the option compares with other HubSpot routes

The remote MCP server works against CRM context, whereas the developer MCP server is a local development assistant for apps, CMS assets and developer workflows. The trade-off should be evaluated at the workflow level. A team may use one direct connector for daily analysis, remote MCP for an internal agent, and APIs for production systems without creating unnecessary duplication if each path has a clear role.

Connection choice also affects support and change management. A native connector can be easier for business users to understand, while protocol-level MCP gives technical teams more flexibility. Traditional APIs require more engineering but offer precise contracts. MCP Server should therefore be selected for the work it simplifies, not as a universal architecture rule.

For teams using the hosted MCP server, cost is not only subscription price. Consider admin time, engineering effort, permission management, user training and the cost of correcting bad changes. A connection that is nominally free can be expensive if it creates constant manual review, while a structured workflow can justify itself quickly by removing repetitive CRM preparation.

Team governance, approvals and auditability

Governance for MCP Server should be concrete enough that users know what is expected without needing a policy document open beside them. Define approved accounts, write permissions, data categories and when confirmation is mandatory. Pair those rules with HubSpot auditability so managers can trace important changes back to the user and integration involved.

For teams using the hosted MCP server, small teams can keep governance lightweight by assigning one owner for access and one owner for workflow quality. Larger teams may need role-based examples and separate standards for sales, support and marketing. The principle stays the same: users should know what the assistant may do before they discover the boundary through an error.

A monthly review of high-value MCP Server workflows is often enough to catch drift. Look for prompts that users stopped trusting, permissions that became broader than necessary, and actions that generate frequent corrections. Remove or redesign weak workflows rather than carrying them forward simply because the integration remains available.

Measure whether the workflow is actually saving time

Measure MCP Server against successful authentication, available object coverage, write-action success rate, audit-log visibility and reduction in custom integration code. Those measures show whether the tool is actually changing productivity or merely moving work into a new interface. A successful connection should reduce steps, shorten cycle time or improve decision quality without creating a larger review burden somewhere else.

Baseline the process before adoption where possible. If a pipeline review takes forty minutes today, record that. If reps frequently leave HubSpot to assemble account context, count those steps. After MCP Server is introduced, the team can compare the new workflow with a real before-state rather than relying on enthusiasm from early adopters.

Quality metrics deserve equal weight with speed. Track correction rate, abandoned outputs and changes reversed after review. The best MCP Server workflow is not necessarily the fastest; it is the one that produces dependable work with less total effort after checking, correcting and communicating the result.

When to use a more deterministic integration

Some processes should remain outside MCP Server. High-volume synchronization, billing-critical logic, complex validation and event-driven integrations generally benefit from explicit application code or HubSpot-native automation. Conversational tooling can still help people inspect those systems, but it should not automatically inherit responsibility for every production path.

A useful boundary is determinism. If the same input must always produce the same action, APIs and automation are usually easier to test. If the user is asking an open-ended question, interpreting context or choosing among reasonable next steps, MCP Server becomes more attractive because language and judgment are part of the job.

Hybrid architecture is normal. The underlying business system can keep APIs and workflows for deterministic work while MCP Server exposes a limited set of approved tools to humans or agents. This approach preserves reliability where it matters and still gives users a conversational way to work with CRM context.

A rollout plan for the first 30 days

The first month with MCP Server should focus on a few repeatable workflows, not organization-wide transformation. Week one can establish access and read-only use cases. Week two can add a small number of approved actions. Weeks three and four can measure adoption, correction rate and time saved before the team decides what deserves wider rollout.

Document the winning workflow in plain language: who starts it, what they ask, what HubSpot data is involved, what the assistant returns and who approves any change. That small operating recipe makes MCP Server easier to teach and prevents a useful experiment from depending on one power user who remembers all the hidden steps.

For teams using the hosted MCP server, expansion should follow evidence. Add more users or permissions when the existing workflow is accurate, understandable and measurably useful. If adoption is low, investigate whether the problem is prompt design, data quality or a poor fit with the role before investing in broader automation. Scale the behavior that works, not the novelty.

HubSpot 14-Day Free TrialTry HubSpot premium marketing and CRM workflows free for 14 daysNo credit card or commitment required.
Start Your Free 14-Day HubSpot Trial →

Key HubSpot product details

  • Remote MCP endpoint: HubSpot hosts the remote server at https://mcp.hubspot.com.
  • Remote MCP status: The remote HubSpot MCP server is generally available and supports expanded CRM read/write workflows.
  • Developer MCP: The local Developer MCP server is a separate GA product for app, CMS and developer work.
  • Direct connectors: HubSpot provides official routes for ChatGPT, Claude, Gemini and Microsoft Copilot, with capabilities varying by client.

Frequently asked questions

What is MCP Server?

The remote HubSpot MCP server is HubSpot-hosted, uses OAuth 2.1 with PKCE, and can expose supported CRM data and actions to compatible MCP clients.

It is most useful for admins and developers evaluating the hosted HubSpot MCP endpoint when the workflow is tied to a concrete decision rather than treated as a standalone dashboard or AI experiment.

Who should use MCP Server?

MCP Server fits admins and developers evaluating the hosted HubSpot MCP endpoint. The strongest fit appears when the team can name the recurring question or decision it wants to improve.

If the underlying process is undefined, fix that first. A clear workflow makes it much easier to judge whether MCP Server is saving time or improving decisions.

What is the biggest limitation of MCP Server?

Incorrect scopes, stale authorizations or over-broad access can create confusing failures or unnecessary data exposure.

That does not make MCP Server unsuitable; it means the team should design access, capacity or measurement around the limitation instead of discovering it after rollout.

How should I evaluate MCP Server?

Track successful authentication, available object coverage, write-action success rate, audit-log visibility and reduction in custom integration code. Those measures reveal whether the product changes work that matters.

For teams using the hosted MCP server, use a defined before-and-after period where possible, and include quality or correction measures rather than evaluating speed alone.

What should I do first with MCP Server?

Start by create the MCP auth app, connect the client to the hosted endpoint, inspect available tools and user permissions, then test one controlled workflow before expanding.

For teams using the hosted MCP server, keep the first use case narrow enough that the expected outcome is obvious. Expand only after the team can explain what worked and what needs additional control.

How does MCP Server compare with alternatives?

The remote MCP server works against CRM context, whereas the developer MCP server is a local development assistant for apps, CMS assets and developer workflows.

For teams using the hosted MCP server, the best choice depends on the workflow, scale and software already in use, so compare total operating fit rather than headline feature counts alone.

HubSpot 14-Day Free TrialTry HubSpot premium marketing and CRM workflows free for 14 daysNo credit card or commitment required.
Start Your Free 14-Day HubSpot Trial →

Cloudzat may earn a commission if you join HubSpot through links on this page. This does not change your price. Calculator and selector results are estimates. Your final HubSpot cost and available features depend on the plan, billing choice, permissions and add-ons you select.

Scroll to Top