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

Setup

Installing via Smithery

To install hubspot-mcp-summary for Claude Desktop automatically via Smithery:

Manual Installation

1. Install Dependencies
   npm install
2. Create a .env FileCreate a .env file in the project root with your HubSpot credentials:
   HUBSPOT_ACCESS_TOKEN=your_access_token_here USER_ROLES_FILE=path/to/user_roles.json
3. Build the ProjectCompile your TypeScript files:
   npm run build
4. Start the ServerStart the MCP server:
   npm start

Development

To run the server in development mode with hot-reloading:

Testing with MCP Inspector

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

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

Configuration

The server can be configured using environment variables:

• HUBSPOT_ACCESS_TOKEN: Your HubSpot API access token
• USER_ROLES_FILE: Path to the user roles configuration file

License

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