HubSpot MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with HubSpot CRM. This server allows you to create, update, delete, and fetch summary records (stored as Note engagements) in HubSpot.

DockerFile

docker build -t mcp-hubspot-ts .
docker run --env-file .env -it mcp-hubspot-ts

Features

Create a summary as a Note engagement in HubSpot
Fetch all summary records (Notes) from HubSpot
Filter summary records by date
Update existing summary records
Delete summary records
Send summary records via chat or email

Testing with MCP Inspector

To inspect and test your MCP server implementation, you can use the MCP Inspector. For example:

npx @modelcontextprotocol/inspector -e HUBSPOT_ACCESS_TOKEN=your_access_token_here node build/index.js

This will start the MCP Inspector UI on http://localhost:5173. Use the UI to send JSON-RPC requests to your server.

Env

Create a .env file in the project root with your HubSpot credentials:

HUBSPOT_ACCESS_TOKEN=your_access_token_here
SHARED_CONTACT_ID=your_contact_id_here

License

This project is licensed under the MIT License - see the LICENSE file for details.