This MCP server provides a HubSpot integration that lets AI assistants interact with your HubSpot CRM data. It exposes tools to create and manage contacts and companies, retrieve detailed activity histories and engagement data, and fetch recently active records. Authentication is handled via a HubSpot access token, which can be supplied as an environment variable or via a CLI flag at startup. Once running, you can invoke the available HubSpot tools from compatible AI agents to perform CRM operations without leaving the conversational interface.

Key capabilities include creating contacts and companies with duplicate checking, retrieving comprehensive activity history for a given company, listing recent engagements across your HubSpot instance, and querying the most recently active contacts or companies. You can also update existing contacts and companies by providing the relevant IDs and property sets. The server uses the mcp-proxy-auth package when you enable authentication for an extra layer of security, ensuring only authenticated clients can access the HubSpot tools.

Prerequisites:

• Node.js and npm installed
• Access to a HubSpot account and a HubSpot API access token with the required scopes (contacts, companies, engagements)

Installation steps:

1. Clone the repository git clone https://github.com/lkm1developer/hubspot-mcp-server.git cd hubspot-mcp-server

2. Install dependencies npm install

3. Build the project npm run build

4. Configure environment variables (examples) HUBSPOT_ACCESS_TOKEN=your-access-token

5. Start the server (example) npm start

   or with a token passed explicitly

   npm start -- --access-token=your-access-token

Tips and notes:

• Store your HubSpot access token securely. Prefer environment variables or a secret manager in production.
• If you enable authentication for the SSE server, configure AUTH_SERVER_URL to point to your API key verification endpoint and run the proxy-auth helper as described in the docs.
• The server exposes a range of tools under the hubspot_* namespace. Extend capabilities by updating src/hubspot-client.ts and registering new tools in src/index.ts, then rebuild with npm run build.
• Ensure the HubSpot token has the necessary scopes: contacts, companies, engagements. Revoking or rotating tokens may require updating the configured token.
• When testing, you can fetch recent activities or active records using the provided parameters (e.g., days, limit) to tune the volume of data returned.