Lkm1developer Hubspot MCP Server

🚀 HubSpot MCP Server

This project is a powerful MCP (Model Context Protocol) server implementation written in TypeScript, specifically designed for integration with HubSpot CRM. Its main purpose is to enable AI assistants to interact with HubSpot data.

🚀 Quick Start

This section provides a step - by - step guide on how to install, configure, and run the HubSpot MCP server.

📦 Installation

1. Clone the repository

git clone https://github.com/yourusername/hubspot-mcp-server.git
cd hubspot-mcp-server

2. Install dependencies

npm install

3. Build the project

npm run build

4. Configuration

• Use environment variables:

HUBSPOT_API_KEY=your_api_key_here

• Or specify the API key using command - line arguments when starting the server:

npm start -- --apiKey your_api_key_here

💻 Usage Examples

Run the server locally

npm run dev

Run in production environment

npm start

Deploy with Docker

# Dockerfile
FROM node:16

WORKDIR /app

COPY package*.json ./

RUN npm install

COPY . .

CMD ["node", "dist/index.js"]

Tool Functions

The following are the tools supported by the server and their detailed descriptions:

Create a company

{
  toolName: 'hubspot_create_company',
  parameters: {
    name: string,
    properties?: object
  }
}

Get company activity records

{
  toolName: 'hubspot_get_company_activity',
  parameters: {
    companyId: string
  }
}

Get recent engagement records

{
  toolName: 'hubspot_get_recent_engagements',
  parameters: {
    days?: number,
    limit?: number
  }
}

Get the most active companies

{
  toolName: 'hubspot_get_active_companies',
  parameters: {
    limit?: number
  }
}

Get the most active contacts

{
  toolName: 'hubspot_get_active_contacts',
  parameters: {
    limit?: number
  }
}

Update contact information

{
  toolName: 'hubspot_update_contact',
  parameters: {
    contactId: string,
    properties: object
  }
}

Update company information

{
  toolName: 'hubspot_update_company',
  parameters: {
    companyId: string,
    properties: object
  }
}

🔧 Technical Details

To add new HubSpot API functionality, follow these steps:

1. Add a new method to the HubSpotClient class in src/hubspot-client.ts.
2. Register the new tool in the setupToolHandlers method of src/index.ts.
3. Rebuild the project using the command npm run build.

📄 License

This project is licensed under the MIT license. For specific details, please refer to the LICENSE file.

🔑 Keywords

HubSpot, CRM, Model Context Protocol, MCP, AI Assistant, TypeScript, API Integration, HubSpot API, CRM Integration, Contact Management, Company Management, Engagement Tracking, AI Tools