> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

---
id: 3ae0b774-fc17-4d20-b32c-03c0db0a5cde
---

# Using the HubSpot MCP server

> Connect an external AI tool or application to your CRM over OAuth.

The remote HubSpot MCP server is a publicly hosted endpoint for connecting external AI tools and applications to HubSpot's CRM. It enables an agent to read, write, and update HubSpot records (contacts, companies, deals, tickets, and more) as a user would.

<Note>
  **Already using Claude, ChatGPT, Microsoft Copilot, or Gemini?** HubSpot offers [AI connectors](https://www.hubspot.com/ai-tools) for those tools, so you can work with your HubSpot data directly without building a custom integration. The HubSpot MCP server is for builders who need to integrate HubSpot data access into an agent they're creating.
</Note>

Unlike the Developer MCP server, which helps you build on HubSpot's platform, the remote HubSpot MCP server is designed for agents to take actions within a user's HubSpot account on their behalf. HubSpot's own AI connectors for Claude, Microsoft Copilot, Gemini, and ChatGPT are powered by this server.

```mermaid theme={null}
flowchart LR
    A["Your agent"] -- "1. Tool call" --> B["remote HubSpot MCP server"]
    B -- "2. API request" --> C["HubSpot"]
    C -- "3. Returns data or confirms action" --> B
    B -- "4. Structured response" --> A
```

## When to use the HubSpot MCP server

The remote HubSpot MCP server is a good fit when you want your agent to be able to:

* **Pull contact lists:** find contacts matching specific criteria (lifecycle stage, last activity date, deal association) without building a filter in HubSpot.
* **Ask questions about their pipeline:** get plain-language summaries of where deals stand, which ones are stalled, and what changed recently.
* **Turn meeting notes into record updates:** describe what happened in a meeting and have the agent create or update the right contacts, companies, and deals.
* **Understand why deals are lost:** surface common patterns across closed-lost deals by asking the agent to analyze deal properties and activity history.

## Getting connected

The remote HubSpot MCP server uses <Tooltip headline="OAuth" tip={`A secure authorization method that lets an app access data in another system (like HubSpot) on behalf of a user, without sharing their password. When you "connect" an app and see a permissions screen, that's OAuth at work.`} cta="https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/oauth/working-with-oauth">OAuth</Tooltip> to connect securely to your HubSpot account. The setup process varies depending on which AI tool you're using, but the general steps are:

1. Open your AI tool's settings and add a new MCP server connection.
2. Enter the HubSpot MCP server URL provided by HubSpot (`https://mcp.hubspot.com`).
3. Authorize the connection by signing in to your HubSpot account when prompted.

The AI tool handles the authentication flow for you, so you don't need to manage <Tooltip headline="What are OAuth tokens?" tip="Temporary credentials generated during the OAuth process that an app uses to access your HubSpot data on your behalf. They replace the need to share your password and can be limited in what they're allowed to do using scopes.">tokens</Tooltip> or configure <Tooltip headline="OAuth Scopes/App permissions" tip="Scopes define what an app is allowed to do in your account. For example, an app might have permission to read contacts but not delete them. This ensures an app can only do what the user expects it to do." cta="https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/oauth/working-with-oauth#configure-scopes">OAuth scopes</Tooltip> manually.

For full setup instructions, see [Integrate with the remote HubSpot MCP server](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server).