Advertise
MCP.so
Sign In

HubSpot MCP Server

@lkm1developer

Repository

Basic information

Category

Data & Analytics

License

MIT

Transports

stdio

Author

lkm1developer

About HubSpot MCP Server

hubspot mcp server

#hubspot#crm#mcp-server#ai-assistant

HubSpot MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "hubspot-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-proxy-auth",
        "node",
        "dist/index.js"
      ]
    }
  }
}

HubSpot MCP Server tools

8

`firstname` (string, required): Contact's first name

`name` (string, required): Company name

`company_id` (string, required): HubSpot company ID

`days` (number, optional, default: 7): Number of days to look back

`limit` (number, optional, default: 10): Maximum number of companies to return

`limit` (number, optional, default: 10): Maximum number of contacts to return

`contact_id` (string, required): HubSpot contact ID to update

`company_id` (string, required): HubSpot company ID to update

Overview

What is HubSpot MCP Server?

HubSpot MCP Server is a Model Context Protocol (MCP) server implementation that enables AI assistants to interact with HubSpot CRM data. It provides tools for creating and managing contacts and companies, retrieving company activity histories, accessing recent engagements, and fetching lists of active contacts and companies.

How to use HubSpot MCP Server?

Clone the repository, install dependencies with npm install, and build with npm build. Configure a HubSpot API access token as an environment variable (HUBSPOT_ACCESS_TOKEN) or pass it as a command-line argument (--access-token). Start the server with npm start. For an authenticated SSE server, use npx mcp-proxy-auth node dist/index.js and set the AUTH_SERVER_URL environment variable.

Key features of HubSpot MCP Server

  • Create contacts and companies with duplicate checking
  • Retrieve comprehensive company activity and engagement timelines
  • Get recent engagement data across all contacts and companies
  • Fetch lists of recently active companies and contacts
  • Update existing contacts and companies by ID

Use cases of HubSpot MCP Server

  • AI assistants creating and managing HubSpot contacts and companies via natural language
  • Retrieving detailed activity history for a specific company
  • Accessing recent engagement data (emails, calls, meetings, notes, tasks) across the entire HubSpot instance
  • Getting lists of recently modified companies and contacts for CRM monitoring

Frequently asked questions

1

What does the HubSpot MCP Server do?

It provides a set of MCP tools that allow AI assistants to perform HubSpot CRM operations such as creating/updating contacts and companies, retrieving activity histories, and accessing recent engagements.

2

How do I obtain a HubSpot API access token?

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

3

How can I provide the access token to the server?

Set the token as the `HUBSPOT_ACCESS_TOKEN` environment variable in a `.env` file, or pass it as a command-line argument with `--access-token=your-token` when starting the server.

4

How do I implement authentication for the SSE server?

Install the `mcp-proxy-auth` package, set the `AUTH_SERVER_URL` environment variable to your API key verification endpoint, and run `npx mcp-proxy-auth node dist/index.js`. The SSE URL will be `localhost:8080/sse?apiKey=apikey`.

5

How can I extend the server with 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`.

Comments

More Data & Analytics MCP servers

hedwigai

hedwigai

Research workbooks your agent keeps current: spreadsheets and memos where every figure cites its primary source (SEC filings, customs records, trial registries), plus data programs such as website traffic for 1,000 domai

Statable

Key Arg B.V.

Privacy-first, cookieless web analytics hosted in the EU. Query visitors, pages, traffic sources, countries, goals, funnels and live traffic for your sites, and create sites, goals and funnels — 25 tools over OAuth.

StoreRadar

StoreRadar

Search, count and inspect 2.6M+ live Shopify stores from your AI assistant. Filter by installed apps, tech stack, theme, country and catalog size. Read only. Free to connect.

AdLoop Cloud

kLOsk

Hosted AdLoop: Google Ads, Reddit Ads, GA4 and Tag Manager in claude.ai, ChatGPT and more, with a preview before every change.

Companero – Romanian Company Data

Companero

Remote MCP server for Romanian company data: search 2.7M Romanian companies by CUI, county, CAEN industry, revenue and founding date; get company profiles, balance sheets, ANAF tax debts, legal representatives and due di

Advertise