Advertise
MCP.so
Sign In

HubSpot MCP Server

@Meerkats-Ai

Repository

Basic information

Category

Data & Analytics

License

MIT license

Transports

stdio

Author

Meerkats-Ai

About HubSpot MCP Server

hubspot-mcp-server typescript

#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-meerkats-ai": {
      "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?

The HubSpot MCP Server is a Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data. It provides a set of tools for performing CRM operations – such as creating, updating, and retrieving contacts and companies – through natural language commands.

How to use HubSpot MCP Server?

Clone the repository, install dependencies (npm install), and build the project (npm run build). Provide a HubSpot API access token either as the HUBSPOT_ACCESS_TOKEN environment variable or as a --access-token command-line argument. Start the server with npm start and integrate it with any MCP-compatible AI assistant. For an SSE server with authentication, use npx mcp-proxy-auth.

Key features of HubSpot MCP Server

  • Create contacts and companies with duplicate checking
  • Update existing contacts and companies
  • Retrieve detailed company activity history
  • Get recent engagement data across all objects
  • List recently active companies and contacts

Use cases of HubSpot MCP Server

  • Manage CRM records directly from an AI assistant interface
  • Pull up a company’s full activity timeline during a conversation
  • Monitor recent engagements (calls, meetings, notes) across the instance
  • Quickly find the most recently modified contacts or companies

Frequently asked questions

1

What authentication is required for HubSpot MCP Server?

A HubSpot API access token from a private app with scopes for contacts, companies, and engagements.

2

How do I provide the access token?

Set the `HUBSPOT_ACCESS_TOKEN` environment variable or pass it as `--access-token` on the command line. A `.env` file can also be used.

3

What tools does HubSpot MCP Server expose?

It exposes eight tools: `hubspot_create_contact`, `hubspot_create_company`, `hubspot_update_contact`, `hubspot_update_company`, `hubspot_get_company_activity`, `hubspot_get_recent_engagements`, `hubspot_get_active_companies`, and `hubspot_get_active_contacts`.

4

Can I add more HubSpot API capabilities?

Yes. Add new methods to the `HubSpotClient` class, register them in `setupToolHandlers`, and rebuild with `npm run build`.

5

Does the SSE server support authentication?

Yes, using the `mcp-proxy-auth` package. Set the `AUTH_SERVER_URL` environment variable and run `npx mcp-proxy-auth` to require an API key for access.

Comments

More Data & Analytics MCP servers

Lawstronaut Legal Research

Lawstronaut-FZCO

Connect your AI to millions of laws and court cases! Lawstronaut is the infrastructure layer that connects AI agents and software to millions of legal documents across 150+ jurisdictions, structured legal data, continuou

1

TikTok MCP Server

HasData

Hosted TikTok MCP server for AI agents: read public profiles, account videos, comments and replies, or search videos and creators. Structured JSON for creator research and content analysis.

3

Convertlyft

Convertlyft

Website analytics and SEO in one. Every visit counted, no sampling. Each to-do says what leaked and the change to make, with the numbers behind it, you can visit us on Convertlyft.com first 5,000 Visits to your website f

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.

SiteGuru

Your site's real SEO data in your AI assistant. SiteGuru crawls your website and connects to Google Search Console and Google Analytics. This server exposes that data to your assistant, so you can ask what's broken, wha

Advertise