HubSpot MCP Server

# HubSpot MCP Server ## Overview This project implements a Model Context Protocol (MCP) server that integrates with HubSpot CRM and now includes a centralized shared space feature. The server enables AI models to interact with HubSpot data and operations through a standardized interface while allowing teams to share key conversation summaries in real time. For more information about the Model Context Protocol and how it works, see Anthropic's MCP documentation. <a href="https://glama.ai/mcp/servers/vpoifk4jai"><img width="380" height="200" src="https://glama.ai/mcp/servers/vpoifk4jai/badge" alt="HubSpot Server MCP server" /></a> ## Components ### Resources No resources are implemented. Ultimately, the system is driven by the tools. ### Example Prompts Create HubSpot contacts by copying from a LinkedIn profile webpage: ```yaml # Example YAML prompt - Create HubSpot contacts and companies from following: - John Doe - Software Engineer at Tech Corp - San Francisco Bay Area • 500+ connections Experience: - Tech Corp - Software Engineer - Jan 2020 - Present · 4 yrs - San Francisco, California - Previous Company Inc. - Senior Developer - 2018 - 2020 · 2 yrs Education: - University of California, Berkeley - Computer Science, BS - 2014 - 2018 ``` Get latest activities for your company: ```vbnet # Example VB.NET prompt - What's happening latestly with my pipeline? ``` ### Shared Space Example: After a meeting, an AI command box prompts: "Kya aap is conversation summary ko company ke shared space mein share karna chahenge? (Yes/No)" On confirmation, the conversation summary is stored centrally and accessible to all authorized managers in your company. ## Tools The server offers several tools for managing HubSpot objects along with new shared space tools: ### Contact Management Tools - `hubspot_create_contact` - Create a new contact in HubSpot (with duplicate checking). - **Inputs:** - firstname (string) - lastname (string) - email (string, optional) - properties (dict, optional; e.g., {"phone": "123456789", "company": "HubSpot"}) ### Company Management Tools - `hubspot_create_company` - Create a new company in HubSpot (with duplicate checking). - **Inputs:** - name (string) - properties (dict, optional) - `hubspot_get_company_activity` - Retrieve the activity history for a specific company. - **Input:** - company_id (string) ### Engagement Tools - `hubspot_get_recent_engagements` - Retrieve recent engagement activities. - **Inputs:** - days (integer, default 7) - limit (integer, default 50) - `hubspot_get_recent_companies` - Retrieve most recently active companies. - **Input:** - limit (integer, default 10) - `hubspot_get_recent_contacts` - Retrieve most recently active contacts. - **Input:** - limit (integer, default 10) ### Shared Space Tools - `create_shared_summary` - Create a new conversation summary in the shared space. - **Inputs:** - user_id (string, the user’s email/ID) - company_id (string) - summary (string) - `get_shared_summaries` - Retrieve all conversation summaries for a given company. - **Inputs:** - user_id (string) - company_id (string) These shared space tools allow authorized managers to share meeting summaries, enabling real-time team collaboration and centralized access to key insights. ## Setup ### Installing via Smithery To install buryhuang/mcp-hubspot for Claude Desktop automatically via Smithery: ```bash npx -y @smithery/cli install buryhuang/mcp-hubspot --client claude ``` ### Prerequisites You'll need a HubSpot access token. Obtain one by creating a private app in your HubSpot account (see HubSpot Private Apps Guide). Keep your token secure. ### Docker Installation **Option 1:** Pull from Docker Hub ```bash docker pull buryhuang/mcp-hubspot:latest ``` **Option 2:** Build Locally ```bash docker build -t mcp-hubspot . ``` Run the container: ```bash docker run -e HUBSPOT_ACCESS_TOKEN=your_access_token_here buryhuang/mcp-hubspot:latest ``` Or pass the token as an argument: ```bash docker run buryhuang/mcp-hubspot:latest --access-token your_access_token_here ``` ### Cross-Platform Publishing Create a new builder instance: ```bash docker buildx create --use ``` Build and push for multiple platforms: ```bash docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t buryhuang/mcp-hubspot:latest --push . ``` Verify the image: ```bash docker buildx imagetools inspect buryhuang/mcp-hubspot:latest ``` ### Usage with Claude Desktop #### Installing via Smithery ```bash npx -y @smithery/cli@latest install mcp-hubspot --client claude ``` #### Docker Usage ```json { "mcpServers": { "hubspot": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "HUBSPOT_ACCESS_TOKEN=your_access_token_here", "buryhuang/mcp-hubspot:latest" ] } } } ``` Or using command-line argument: ```json { "mcpServers": { "hubspot": { "command": "docker", "args": [ "run", "-i", "--rm", "buryhuang/mcp-hubspot:latest", "--access-token", "your_access_token_here" ] } } } ``` ## Development To set up the development environment: ```bash pip install -e . ``` ### Shared Space Integration The shared space functionality is implemented in a separate module (shared_space.py). This module: - Loads dynamic user roles (from an external JSON file or database). - Implements CRUD endpoints (create_summary, get_summaries, update_summary, and delete_summary) for conversation summaries. - Triggers a real-time notification placeholder (which you can later integrate with SSE or WebSockets). The main server.py file imports these functions and registers them as new MCP tools (create_shared_summary and get_shared_summaries). ## License This project is licensed under the MIT License. This updated README now reflects the additional shared space functionality using HubSpot MCP integration and explains how the system is structured and used.