MCP.so
Sign In

HubSpot MCP Server

@Meerkats-Ai

Repository

About HubSpot MCP Server

hubspot-mcp-server typescript

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

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"
      ]
    }
  }
}

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

FAQ from HubSpot MCP Server

What authentication is required for HubSpot MCP Server?

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

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.

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.

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.

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.

Frequently asked questions

What authentication is required for HubSpot MCP Server?

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

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.

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`.

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`.

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

Basic information

Category

Data & Analytics

License

MIT license

Transports

stdio

Author

Meerkats-Ai

More Data & Analytics MCP servers

PowerDMARC

powerdmarc

PowerDMARC's MCP server brings live email authentication data directly into any MCP-compatible AI assistant: Claude, ChatGPT, Cursor, and others. Instead of generic DMARC advice, the AI works from a customer's actual acc

CryptoWhaleInsights

CryptoWhaleInsights Team

Real-time crypto whale tracking & market intelligence. Monitors 80+ verified whale wallets across 14 blockchains (BTC, ETH, SOL, BSC, Base, ARB, MATIC, TON, SUI, HYPE, TRX, SEI, INJ, APT). 55 tools: whale movements, fear

Sugra API MCP

Sugra Systems, Inc.

Official MCP server for the Sugra API, giving AI agents source-attributed access to 1,500+ endpoints across 36 data domains from 160+ primary sources. Covers markets, economics, company fundamentals, government, news, cl

1

LeadMarina

LeadMarina

Verified local-business leads: search any niche in any city, query your lead library, and export to Close, GoHighLevel, Google Sheets, or emailed files — every email SMTP-checked, every phone verified with line type and

Bright Data MCP

brightdata-com

A powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access.

2.5K