ajthinking/hubspot-download
If you are the rightful owner of hubspot-download and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server implementation that provides download capabilities for HubSpot CRM.
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
-
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
-
Create a
.envfile 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
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.
