HubSpot Download MCP Server

Overview

A Model Context Protocol (MCP) server implementation that provides download capabilities for HubSpot CRM. CRM Objects are downloaded to a workspace data directory as JSON files.

For more information about the Model Context Protocol and how it works, see Anthropic's MCP documentation.

Features

The server provides two main tools:

1. Download Schema

Downloads the schema for all HubSpot objects (contacts, companies, deals, and tickets) to data/hubspot/schema.json.

2. Download Objects

Downloads objects from HubSpot with their properties:

• Contacts
• Companies
• Deals
• Tickets

Each object type is saved to its own JSON file (e.g., data/hubspot/contacts.json).

Prerequisites

1. HubSpot access token - Create a private app in your HubSpot account:

   • Go to Settings > Integrations > Private Apps
   • Create a new app with these scopes:
     • crm.objects.contacts.read
     • crm.objects.companies.read
     • crm.objects.deals.read
     • crm.objects.tickets.read
   • Copy the access token

2. Create a .env file in your workspace with:

HUBSPOT_ACCESS_TOKEN=your_token_here

Usage with IDEs

Register the MCP like this:

{
  "mcpServers": {
    "hubspot-crm-server": {
      "command": "npx",
      "args": [
        "tsx",
        "TODO"
      ]
    }
  }
}

What properties are downloaded?

The server downloads the following default properties for each object type:

Contacts

• createdate
• hs_lastmodifieddate
• hs_object_id
• lastmodifieddate
• firstname
• lastname
• email

Companies

• createdate
• hs_lastmodifieddate
• hs_object_id
• name

Deals

• createdate
• hs_lastmodifieddate
• hs_object_id
• dealname
• amount
• pipeline
• dealstage
• closedate

Tickets

• createdate
• hs_lastmodifieddate
• hs_object_id
• name

In addition, the server downloads any custom properties you've defined in HubSpot.

License

This project is licensed under the MIT License.