Hubspot MCP Server Pkc

The HubSpot MCP Server is a standardized interface implementation used to connect applications to the HubSpot API, providing CRM data management and workflow automation functions.

Customer data platform Marketing #HubSpot Integration #CRM Docking #Workflow Automation #AI Assistant .TypeScript

rating : 2 points

downloads : 19

update time : 2025-04-23

What is the HubSpot MCP Server?

The HubSpot MCP Server is a bridging tool that simplifies your interaction with the HubSpot API through a standardized protocol (MCP). Whether you're managing customer relationships, handling sales opportunities, or tracking project progress, this tool can help you complete tasks efficiently.

How to use the HubSpot MCP Server?

You can start using it in just a few simple steps: install the tool, set up the API key, and perform the required operations. Whether it's creating contacts, updating company information, or generating new sales opportunities, this tool supports one - click operations.

Applicable Scenarios

Suitable for enterprises that need to automate CRM processes, especially teams that want to simplify sales, marketing, and customer service work.

Main Features

Contact ManagementEasily add, edit, and delete contact records and associate them with relevant companies.

Company ManagementBulk import or modify company information, including attributes such as industry category and geographical location.

Sales Opportunity ManagementTrack the conversion process of potential customers and adjust the stage status to reflect the latest progress.

Custom Object SupportDesign exclusive data models for the specific business needs of enterprises.

Inter - entity AssociationEstablish logical relationships between different objects, such as binding contacts to specific projects.

Timeline Event RecordingTrack historical activities and future plans to ensure team members are synchronized.

Advantages and Limitations

Advantages

Reduce repetitive labor and save a lot of time.

Improve data accuracy and reduce human errors.

Seamlessly integrate with existing systems without additional development work.

Powerful search function to quickly locate target customers.

Multi - dimensional data analysis ability to assist in decision - making.

Limitations

Requires a valid HubSpot API key to run.

Some advanced features may depend on specific subscription plans.

For non - conventional scenarios, customized development may be required.

Has certain requirements for the network environment to ensure a stable connection.

How to Use

Install the Tool

Run the following command to install the HubSpot MCP Server: `npm install @NaorAIdeas/hubspot - mcp - server`.

Configure the API Key

Create a `.env` file in the project root directory and fill in your HubSpot API key.

Start the Server

Execute the command to start the server: `npx @NaorAIdeas/hubspot - mcp - server`.

Usage Examples

Add a New ContactAdd a new contact to the system for subsequent follow - up.

Modify Company InformationUpdate the annual revenue data of a company.

Associate a Project with a ContactAssign a contact to a specific project.

Frequently Asked Questions

Is the HubSpot MCP Server free to use?

How to obtain a HubSpot API key?

Does it support a multi - language interface?

Related Resources

Official Documentation

Comprehensively understand the functions and configuration methods of the HubSpot MCP Server.

GitHub Code Repository

View the source code and participate in open - source contributions.

Video Tutorial

Watch the demonstration video to learn how to quickly get started.

🚀 HubSpot MCP Server

This package implements an MCP server, serving as a bridge between applications and the HubSpot API. It offers a standardized interface to interact with HubSpot's services through the Model Context Protocol.

🚀 Quick Start

Usage Examples

Sales and Project Management

Create a new deal: create new deal
Update a customer record: update customer record
Schedule the next meeting: schedule next meeting

Customer Onboarding

Welcome new customers: welcome new customer
Gather information: gather information
Schedule a follow - up call: schedule follow-up call

Project Handover

Update project status: update project status
Assign a task: assign task
Create a delivery record: create delivery record

How to Use

Command - Line Tool

npx hubspot-mcp-server

Claude Desktop Integration

Add the following content to config.json:

{
  "modelContextProtocol": {
    "apiKey": "your_hubspot_api_key",
    "serverUrl": "http://localhost:3000"
  }
}

📦 Installation

npm install hubspot-mcp-server

⚠️ Important Note

Node.js 14 or a higher version is required.
A valid HubSpot API key must be provided.

Configuration

Obtain a HubSpot API Key

Visit HubSpot.
Log in or create a new account.
Go to Settings > Developers.
Create a new application and enable the required permission scopes.

✨ Features

Contact management: Add, update, and delete contact records.
Company management: Manipulate company information and relationships.
Association management: Handle the links between projects and participants.
Timeline events: Create and update calendar activities.
Ticket system: Manage support requests and status changes.

Development

Environment Variables

Create a .env file:

HUBSPOT_API_KEY=your_hubspot_api_key_here

Build the Project

npm run build

Development Mode

npm run watch

Dependencies

@hubspot/api - client: HubSpot API client.
@modelcontextprotocol/sdk: Model Context Protocol SDK.
dotenv: Environment variable management tool.
zod: Data validation library.

📄 License

This project is licensed under the MIT license.

Disclaimer

The software is provided "as is", without any express or implied warranties. In no event shall the author or copyright holder be liable for any damages arising from the use of this software.

Author

Naor Hemed
AI Integration Specialist & Software Engineer
Passionate about building intelligent systems to transform business processes.

GitHub | LinkedIn | Email

Contribute

This project is built with sincere love and passion for AI. Feel free to contact us to learn how to contribute, ask questions, or discuss AI - driven business processes!

Featured MCP Services