HubSpot MCP Server logo

HubSpot MCP Server

by MCP-Mirror

A powerful Model Context Protocol (MCP) server implementation for seamless HubSpot CRM integration, enabling AI assistants to interact with your HubSpot data. It provides a comprehensive set of tools for interacting with the HubSpot CRM API.

View on GitHub

Last updated: N/A

What is HubSpot MCP Server?

This MCP server is a tool that allows AI assistants to interact with your HubSpot CRM data through the Model Context Protocol. It provides a set of tools for creating, managing, and retrieving data from HubSpot.

How to use HubSpot MCP Server?

To use this server, you need to clone the repository, install dependencies, build the project, and configure it with a HubSpot API access token. You can then start the server and integrate it with AI assistants that support the Model Context Protocol. The server exposes several tools for interacting with HubSpot data.

Key features of HubSpot MCP Server

  • Seamless AI Integration

  • Simplified CRM Operations

  • Real-time Data Access

  • Secure Authentication

  • Extensible Design

Use cases of HubSpot MCP Server

  • Creating and managing contacts and companies in HubSpot CRM

  • Retrieving detailed company activity history and engagement timelines

  • Accessing recent engagement data across your entire HubSpot instance

  • Getting lists of recently active companies and contacts

  • Performing CRM operations without leaving your AI assistant interface

FAQ from HubSpot MCP Server

How do I obtain a HubSpot API access token?

Go to your HubSpot Developer Account, create a private app with the necessary scopes (contacts, companies, engagements), and copy the generated access token.

How do I provide the HubSpot API access token?

You can provide the token as an environment variable (HUBSPOT_ACCESS_TOKEN) or as a command-line argument (--access-token=your-access-token).

How do I implement authentication in the SSE server?

Install the mcp-proxy-auth package, set the AUTH_SERVER_URL environment variable to point to your API key verification endpoint, and run the SSE server with authentication using npx mcp-proxy-auth node dist/index.js.

How do I add new HubSpot API capabilities?

Add new methods to the HubSpotClient class in src/hubspot-client.ts, register new tools in the setupToolHandlers method in src/index.ts, and rebuild the project with npm run build.

What tools are available for interacting with HubSpot?

The server exposes tools for creating and updating contacts and companies, getting company activity, getting recent engagements, and getting active companies and contacts.