Skip to main content
The HubSpot Model Context Protocol (MCP) server enables AI assistants and Large Language Models to securely interact with your HubSpot CRM data through natural conversation. By implementing the Model Context Protocol standard, this remote server acts as a bridge between AI systems and HubSpot’s APIs, allowing for intelligent automation and insights without requiring users to understand complex API structures. For developers, the remote HubSpot MCP server provides secure, granular access to HubSpot CRM data through AI agents and third-party applications, and allows teams to build custom workflows, automate reporting, and integrate HubSpot context into 3rd party applications. For end-users, it creates a more streamlined, simpler way to query their HubSpot data using natural language.
The HubSpot MCP server documented on this page is separate from the developer MCP server. The developer MCP server helps developers build apps and CMS content assets locally on HubSpot’s developer platform. In contrast, the HubSpot MCP server is intended for making requests to an account’s CRM data, similar to using HubSpot’s APIs.

​
Implementation overview

At a high level, integrating with the HubSpot MCP server involves:
  1. Creating an MCP auth app in your HubSpot account.
  2. Configuring your MCP client to connect to the HubSpot MCP server at https://mcp.hubspot.com using your app’s OAuth credentials.
  3. Prompting your MCP client using natural language to query your HubSpot data.
Once you’ve created your MCP auth app, you can use it with any MCP client that supports OAuth authentication with PKCE (Proof Key for Code Exchange). PKCE is required for authenticating with HubSpot’s MCP server.
Some MCP clients, like the MCP Inspector, handle PKCE automatically. If you’re building a custom integration, ensure your OAuth implementation includes PKCE support. Learn more about OAuth 2.1 authorization in the MCP specification.

​
Supported data

The HubSpot MCP Server supports read-only access to the following CRM objects: contacts, companies, deals, tickets, carts, products, orders, line items, invoices, quotes, and subscriptions. The specific CRM object data that the MCP server can query is based on the permissions that the user grants the app during installation. Unlike apps that are installed account-wide, apps that authenticate MCP server requests will need to be installed by each user.
Behind the scenes, the HubSpot MCP server is based on the CRM search API, which currently doesn’t include vector search capabilities.

​
Create an MCP auth app

Create an MCP auth app in your HubSpot account.
  • In your HubSpot account, navigate to Development.
  • In the left sidebar menu, navigate to MCP Auth Apps.
Screenshot of the MCP auth apps page in HubSpot
  • In the upper right, click Create MCP auth app.
  • In the dialog box, enter your app details, which you can update later as needed:
    • App name: the name of your app.
    • Description: an optional description of your app.
    • Redirect URL: the URL to use for OAuth authentication. If you’ll be testing with the MCP inspector, you’ll need to include http://localhost:6274/oauth/callback/debug as a redirect URL.
    • Icon: an optional icon for your app.
  • Click Create.
HubSpot will then generate an app configured with OAuth authentication using the details you provided. You’ll then be redirected to the app’s details page, where you can view its client credentials, redirect URLs, and more. To edit your app details, you can click Edit info in the upper right.
If you’re including multiple redirect URLs, the first redirect URL will be used as the default redirect.
Screenshot of the MCP auth app details page in HubSpot
You can then proceed to connect your MCP client to the HubSpot MCP server, using your app to authenticate requests. For quick testing, you can use the MCP inspector tool, as described in the next section. Otherwise, you can continue to the General MCP client connection section for general instructions.

​
Test with the MCP inspector

The MCP Inspector is a debugging tool that handles OAuth with PKCE automatically, making it a quick way to test your connection to HubSpot’s MCP server without building a full integration. To connect using MCP Inspector:
  • Run the MCP Inspector tool locally.
  • In the browser window that loads the MCP Inspector, configure the environment fields in the left sidebar as follows:
    • Transport Type: Streamable HTTP
    • URL: https://mcp.hubspot.com/
    • Client ID: your app’s client ID, as displayed in HubSpot.
    • Client secret: your app’s client secret, as displayed in HubSpot.
Screenshot of the left sidebar settings in the MCP inspector
  • With your initial details configured, click Open Auth Settings.
Screenshot of the Open Auth Settings button in the MCP inspector
  • In the OAuth Authentication section, click Guided OAuth Flow.
  • In the OAuth Flow Progress section, begin the OAuth flow by clicking Continue below the progress steps.
Screenshot of the Continue button in the OAuth flow progress section
  • Click Continue after each step to proceed to the next.
    • As you progress, the MCP inspector will provide expandable sections with details about the results of each step. This can be helpful for debugging issues with the OAuth flow, such as confirming the authorization URL and token response.
    • During the Preparing Authorization step, an authorization URL will be provided. Click the link icon next to the URL to open it in a new tab and proceed with installing the app in your HubSpot account.
    • At the end of the HubSpot account installation process, an authorization code will be provided, which you’ll need to copy into the Authorization Code field in the MCP inspector.
  • After completing all steps of the OAuth flow, the MCP inspector will display an Authentication successful! message. Your generated token will automatically be used to authenticate requests to the HubSpot MCP server. As you continue to test with the MCP inspector, you can use the Guided Token Refresh, Quick Refresh, and Clear OAuth State buttons to manage your authentication state.
Screenshot of the OAuth token refresh options in the MCP inspector
  • With authentication complete, click Back to Connect in the top right to return to the MCP inspector’s main panel.
  • In the bottom of the left sidebar, click Connect.
The status will then update to Connected and the main panel will display a set of options.
  • In the top bar, select Tools.
Screenshot of the Tools option in the MCP Inspector toolbar
  • Click List Tools.
  • In the tools list, scroll and select get_user_details. The right panel will display details about the tool.
  • Under the tool details in the right panel, click Run tool.
Screenshot of the Run tool button in the MCP inspector
  • After the tool runs, it will return a success message along with information about your user, the account you installed the app in, and will show object and tool data availability, based on the app’s scopes and your user permissions.
Screenshot of a successful response returned by the MCP Inspector

​
General MCP client connection instructions

After creating your MCP auth app, you can connect your MCP client to https://mcp.hubspot.com using your app’s credentials. Your MCP client will need to handle the OAuth flow, including PKCE, to authenticate with HubSpot. To configure your MCP client, you’ll need the following from your app’s details page:
  • Client ID
  • Client secret
  • Redirect URL (must match what’s configured in your MCP client)
During the OAuth flow, you will:
  1. Select the HubSpot account to connect.
  2. Grant permissions to the app. These permissions are based on the user’s permissions in HubSpot and determine what data the app can access.
  3. Authorize the connection.
Once authorized, your MCP client can make requests to the HubSpot MCP server on behalf of the authenticated user.
Not sure where to start with MCP clients? Check out this list of applications that support MCP integrations.
Last modified on January 13, 2026