HubSpot MCP Server
Provides tools for managing HubSpot CRM resources, including contacts, companies, deals, tickets, notes, engagements (calls, emails, meetings, tasks), workflows, associations, owners, pipelines, and properties.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@HubSpot MCP Server create a new contact for John Doe with email john@example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
HubSpot MCP Server
A Model Context Protocol (MCP) server that provides seamless integration with HubSpot's CRM APIs. This server enables Claude Desktop and other MCP clients to manage HubSpot resources and execute CRM operations directly through natural language.
87+ comprehensive tools covering the complete HubSpot CRM workflow including Contacts, Companies, Deals, Tickets, Notes, Engagements (Calls, Emails, Meetings, Tasks), Workflows, Associations, Owners, Pipelines, and Properties management.
Usage
Use with any MCP-compatible client like Claude/Cursor/VS Code. Add the following configuration to your MCP settings:
{
"mcpServers": {
"hubspot": {
"command": "npx",
"args": ["-y", "hubspot-mcp-tools"],
"env": {
"HUBSPOT_ACCESS_TOKEN": "your_access_token_here"
}
}
}
}Replace your_access_token_here with your HubSpot private app access token.
Related MCP server: HubSpot MCP Server
Available Tools
Contacts API (9 tools)
hubspot_create_contact - Create a new contact in HubSpot
hubspot_get_contact - Get a contact by ID from HubSpot
hubspot_list_contacts - List contacts with pagination
hubspot_search_contacts - Search contacts by email, name, or other properties with advanced filtering
hubspot_update_contact - Update contact properties
hubspot_delete_contact - Archive (soft delete) a contact
hubspot_batch_create_contacts - Create multiple contacts at once (max 100)
hubspot_batch_update_contacts - Update multiple contacts at once (max 100)
Companies API (9 tools)
hubspot_create_company - Create a new company in HubSpot
hubspot_get_company - Get a company by ID from HubSpot
hubspot_list_companies - List companies with pagination
hubspot_search_companies - Search companies by name, domain, or other properties with advanced filtering
hubspot_update_company - Update company properties
hubspot_delete_company - Archive (soft delete) a company
hubspot_batch_create_companies - Create multiple companies at once (max 100)
hubspot_batch_update_companies - Update multiple companies at once (max 100)
Deals API (9 tools)
hubspot_create_deal - Create a new deal in HubSpot (use
hubspot_get_pipelinesfor available pipelines/stages)hubspot_get_deal - Get a deal by ID from HubSpot
hubspot_list_deals - List deals with pagination
hubspot_search_deals - Search deals by name, stage, amount, or other properties with advanced filtering
hubspot_update_deal - Update deal properties
hubspot_delete_deal - Archive (soft delete) a deal
hubspot_batch_create_deals - Create multiple deals at once (max 100)
hubspot_batch_update_deals - Update multiple deals at once (max 100)
Tickets API (9 tools)
hubspot_create_ticket - Create a new ticket in HubSpot (use
hubspot_get_pipelinesfor available pipelines/stages)hubspot_get_ticket - Get a ticket by ID from HubSpot
hubspot_list_tickets - List tickets with pagination
hubspot_search_tickets - Search tickets by subject, status, or other properties with advanced filtering
hubspot_update_ticket - Update ticket properties
hubspot_delete_ticket - Archive (soft delete) a ticket
hubspot_batch_create_tickets - Create multiple tickets at once (max 100)
hubspot_batch_update_tickets - Update multiple tickets at once (max 100)
Notes API (7 tools)
hubspot_create_note - Create a note and optionally associate with a HubSpot object
hubspot_get_note - Get a specific note by its ID
hubspot_get_object_notes - Get notes associated with a HubSpot object
hubspot_list_notes - List all notes with pagination
hubspot_update_note - Update note content or properties
hubspot_delete_note - Archive (soft delete) a note
hubspot_search_notes - Search notes by content or properties
Calls API (6 tools)
hubspot_create_call - Log a call engagement with direction, status, duration, and optional CRM association
hubspot_get_call - Get a specific call by its ID
hubspot_list_calls - List all calls with pagination
hubspot_update_call - Update call properties
hubspot_delete_call - Archive (soft delete) a call
hubspot_search_calls - Search calls by properties or full-text query
Emails API (6 tools)
hubspot_create_email - Log an email engagement (sent, received, forwarded) with optional CRM association
hubspot_get_email_engagement - Get a specific email engagement by its ID
hubspot_list_email_engagements - List all email engagements with pagination
hubspot_update_email_engagement - Update email engagement properties
hubspot_delete_email_engagement - Archive (soft delete) an email engagement
hubspot_search_email_engagements - Search email engagements
Meetings API (6 tools)
hubspot_create_meeting - Log a meeting with title, agenda, start/end times, outcome, and optional CRM association
hubspot_get_meeting - Get a specific meeting by its ID
hubspot_list_meetings - List all meetings with pagination
hubspot_update_meeting - Update meeting properties
hubspot_delete_meeting - Archive (soft delete) a meeting
hubspot_search_meetings - Search meetings by properties or full-text query
Tasks API (6 tools)
hubspot_create_task - Create a task with subject, priority, type, due date, and optional CRM association
hubspot_get_task - Get a specific task by its ID
hubspot_list_tasks - List all tasks with pagination
hubspot_update_task - Update task properties or mark as completed
hubspot_delete_task - Archive (soft delete) a task
hubspot_search_tasks - Search tasks by status, priority, or other properties
Workflows API (5 tools)
hubspot_list_workflows - List all automation workflows in HubSpot
hubspot_get_workflow - Get details of a specific workflow by ID
hubspot_enroll_contact_in_workflow - Enroll a contact (by email) into a workflow
hubspot_unenroll_contact_from_workflow - Unenroll a contact from a workflow
hubspot_get_workflow_enrollments - Get contacts currently enrolled in a workflow
Associations API (5 tools)
hubspot_get_association_types - Get all available association types between two object types
hubspot_create_association - Create an association between two HubSpot objects
hubspot_get_associations - Get all associations for a HubSpot object
hubspot_delete_association - Remove an association between two objects
hubspot_batch_create_associations - Create multiple associations at once
Owners API (2 tools)
hubspot_list_owners - List all HubSpot owners (users) in the account
hubspot_get_owner - Get detailed information about a specific owner
Pipelines API (4 tools)
hubspot_get_pipelines - Get all pipelines for deals or tickets
hubspot_get_pipeline - Get detailed pipeline information including stages
hubspot_get_pipeline_stages - Get all stages for a specific pipeline
hubspot_get_pipeline_stage - Get detailed information about a specific stage
Properties API (3 tools)
hubspot_get_properties - Get all available properties for a HubSpot object type
hubspot_get_property - Get detailed property information including options and validation
hubspot_get_property_groups - Get all property groups for a HubSpot object type
Development
Local Setup
Prerequisite:
Node.js v18+
pnpm v9+
Clone the repository:
git clone https://github.com/adeel0x01/hubspot-mcp-tools.git
cd hubspot-mcp-toolsInstall dependencies:
pnpm installBuild the project:
pnpm run buildTesting
pnpm run inspector # Opens MCP InspectorError Handling
The server provides detailed error messages for common issues:
Missing API Key: Clear instructions on how to set the HUBSPOT_ACCESS_TOKEN
HubSpot API Errors: Includes status code, message, and request details for debugging
Validation Errors: Helpful messages for invalid parameters or missing required fields
All errors are logged to stderr (safe for stdio transport) and returned to the client in a structured format.
Important Notes
Security Considerations
Never commit your
.envfile or expose your HubSpot access tokenThe access token is passed via environment variables for security
Use HubSpot private apps with minimal required scopes
HubSpot Access Token
To use this server, you need a HubSpot private app access token with the following scopes:
Required Scopes:
crm.objects.contacts.readandcrm.objects.contacts.writecrm.objects.companies.readandcrm.objects.companies.writecrm.objects.deals.readandcrm.objects.deals.writetickets(read and write)crm.objects.owners.readcrm.schemas.contacts.readcrm.schemas.companies.readcrm.schemas.deals.readcrm.objects.notes.readandcrm.objects.notes.writecrm.objects.calls.readandcrm.objects.calls.writecrm.objects.emails.readandcrm.objects.emails.writecrm.objects.meetings.readandcrm.objects.meetings.writecrm.objects.tasks.readandcrm.objects.tasks.writeautomation(read and write, for workflow management)
Create a private app:
Go to HubSpot Settings > Integrations > Private Apps
Click "Create a private app"
Add the required scopes listed above
Generate the access token
Copy the token and use it as
HUBSPOT_ACCESS_TOKEN
Private Apps Documentation: https://developers.hubspot.com/docs/api/private-apps
Rate Limits
This server respects HubSpot's API rate limits:
Professional/Enterprise: 100 requests per 10 seconds
Batch operations can process up to 100 records at once
Contributing
Contributions are welcome! Please feel free to submit issues or pull requests.
License
MIT
Available Tools
82 toolshubspot_batch_create_associationsC
Create multiple associations at once between objects of the same types.
Inputs: associations (required), toObjectType (required), fromObjectType (required), associationTypeId, +1 more.
hubspot_batch_create_companiesB
Create multiple companies at once (max 100).
Inputs: companies (required).
hubspot_batch_create_contactsB
Create multiple contacts at once (max 100).
Inputs: contacts (required).
hubspot_batch_create_dealsB
Create multiple deals at once (max 100).
Inputs: deals (required).
hubspot_batch_create_ticketsA
Create multiple tickets at once (max 100).
Inputs: tickets (required).
hubspot_batch_update_companiesB
Update multiple companies at once (max 100).
Inputs: companies (required).
hubspot_batch_update_contactsB
Update multiple contacts at once (max 100).
Inputs: contacts (required).
hubspot_batch_update_dealsA
Update multiple deals at once (max 100).
Inputs: deals (required).
hubspot_batch_update_ticketsB
Update multiple tickets at once (max 100).
Inputs: tickets (required).
hubspot_create_associationA
Create an association between two HubSpot objects. Use hubspot_get_association_types to discover valid association type IDs.
Inputs: toObjectId (required), fromObjectId (required), toObjectType (required), fromObjectType (required), +2 more.
hubspot_create_callB
Create a call engagement in HubSpot and optionally associate it with a CRM object.
Inputs: body, title, status, ownerId, +6 more.
hubspot_create_companyB
Create a new company in HubSpot.
Inputs: properties (required).
hubspot_create_contactC
Create a new contact in HubSpot.
Inputs: properties (required).
hubspot_create_dealA
Create a new deal in HubSpot. Use hubspot_get_pipelines to see available pipelines and stages.
Inputs: properties (required).
hubspot_create_emailC
Create an email engagement in HubSpot and optionally associate it with a CRM object.
Inputs: body, html, status, ownerId, +6 more.
hubspot_create_meetingB
Create a meeting engagement in HubSpot and optionally associate it with a CRM object.
Inputs: body, title, endTime, outcome, +5 more.
hubspot_create_noteA
Create a note and optionally associate it with a HubSpot object (contact, company, deal, or ticket).
Inputs: body (required), ownerId, timestamp, associateWith.
hubspot_create_taskB
Create a task in HubSpot and optionally associate it with a CRM object.
Inputs: subject (required), body, type, status, +4 more.
hubspot_create_ticketA
Create a new ticket in HubSpot. Use hubspot_get_pipelines with objectType='tickets' to see available pipelines and stages.
Inputs: properties (required).
hubspot_delete_associationB
Remove an association between two HubSpot objects.
Inputs: toObjectId (required), fromObjectId (required), toObjectType (required), fromObjectType (required).
hubspot_delete_callB
Archive (soft delete) a call engagement in HubSpot.
Inputs: callId (required).
hubspot_delete_companyC
Archive (soft delete) a company in HubSpot.
Inputs: companyId (required).
hubspot_delete_contactB
Archive (soft delete) a contact in HubSpot.
Inputs: contactId (required).
hubspot_delete_dealB
Archive (soft delete) a deal in HubSpot.
Inputs: dealId (required).
hubspot_delete_email_engagementA
Archive (soft delete) an email engagement in HubSpot.
Inputs: emailId (required).
hubspot_delete_meetingB
Archive (soft delete) a meeting engagement in HubSpot.
Inputs: meetingId (required).
hubspot_delete_noteA
Archive (soft delete) a note in HubSpot.
Inputs: noteId (required).
hubspot_delete_taskB
Archive (soft delete) a task in HubSpot.
Inputs: taskId (required).
hubspot_delete_ticketB
Archive (soft delete) a ticket in HubSpot.
Inputs: ticketId (required).
hubspot_enroll_contact_in_workflowB
Enroll a contact (by email address) into a HubSpot workflow.
Inputs: email (required), workflowId (required).
hubspot_get_associationsB
Get all associations for a HubSpot object to another object type.
Inputs: fromObjectId (required), toObjectType (required), fromObjectType (required), after, +1 more.
hubspot_get_association_typesA
Get all available association types between two HubSpot object types. Use this to discover valid associationTypeId values for creating associations.
Inputs: toObjectType (required), fromObjectType (required).
hubspot_get_callB
Get a specific call engagement by its ID.
Inputs: callId (required), properties.
hubspot_get_companyC
Get a company by ID from HubSpot.
Inputs: companyId (required), properties.
hubspot_get_contactC
Get a contact by ID from HubSpot.
Inputs: contactId (required), properties.
hubspot_get_dealB
Get a deal by ID from HubSpot.
Inputs: dealId (required), properties.
hubspot_get_email_engagementB
Get a specific email engagement by its ID.
Inputs: emailId (required), properties.
hubspot_get_meetingA
Get a specific meeting engagement by its ID.
Inputs: meetingId (required), properties.
hubspot_get_noteB
Get a specific note by its ID.
Inputs: noteId (required), properties.
hubspot_get_object_notesC
Get notes associated with a HubSpot object (contact, company, deal, or ticket).
Inputs: objectId (required), objectType (required), limit.
hubspot_get_ownerB
Get detailed information about a specific HubSpot owner by their ID.
Inputs: ownerId (required), archived, idProperty.
hubspot_get_pipelineB
Get detailed information about a specific pipeline including all its stages.
Inputs: objectType (required), pipelineId (required).
hubspot_get_pipelinesA
Get all pipelines for deals or tickets. Pipelines define the stages that records move through.
Inputs: objectType (required).
hubspot_get_pipeline_stageB
Get detailed information about a specific pipeline stage.
Inputs: stageId (required), objectType (required), pipelineId (required).
hubspot_get_pipeline_stagesA
Get all stages for a specific pipeline. Use this to see valid stage values for deals or tickets.
Inputs: objectType (required), pipelineId (required).
hubspot_get_propertiesA
Get all available properties for a HubSpot object type. Use this to discover what fields can be used when creating, updating, or searching objects.
Inputs: objectType (required), archived.
hubspot_get_propertyA
Get detailed information about a specific property including its options, validation rules, and metadata.
Inputs: objectType (required), propertyName (required), archived.
hubspot_get_property_groupsA
Get all property groups for a HubSpot object type. Property groups organize properties into logical sections.
Inputs: objectType (required).
hubspot_get_taskB
Get a specific task by its ID.
Inputs: taskId (required), properties.
hubspot_get_ticketA
Get a ticket by ID from HubSpot.
Inputs: ticketId (required), properties.
hubspot_get_workflowA
Get details of a specific HubSpot workflow by ID.
Inputs: workflowId (required).
hubspot_get_workflow_enrollmentsC
Get contacts currently enrolled in a HubSpot workflow.
Inputs: workflowId (required).
hubspot_list_callsC
List call engagements in HubSpot with pagination.
Inputs: after, limit, properties.
hubspot_list_companiesB
List companies from HubSpot with pagination.
Inputs: after, limit, properties.
hubspot_list_contactsB
List contacts from HubSpot with pagination.
Inputs: after, limit, properties.
hubspot_list_dealsC
List deals from HubSpot with pagination.
Inputs: after, limit, properties.
hubspot_list_email_engagementsC
List email engagements in HubSpot with pagination.
Inputs: after, limit, properties.
hubspot_list_meetingsC
List meeting engagements in HubSpot with pagination.
Inputs: after, limit, properties.
hubspot_list_notesC
List all notes in HubSpot with pagination.
Inputs: after, limit, properties.
hubspot_list_ownersA
List all HubSpot owners (users) in the account. Use this to find owner IDs for assigning contacts, companies, deals, or tickets.
Inputs: after, email, limit, archived.
hubspot_list_tasksC
List tasks in HubSpot with pagination.
Inputs: after, limit, properties.
hubspot_list_ticketsC
List tickets from HubSpot with pagination.
Inputs: after, limit, properties.
hubspot_list_workflowsB
List all automation workflows in HubSpot.
Inputs: no named parameters.
hubspot_search_callsC
Search call engagements in HubSpot.
Inputs: after, limit, query, filters, +1 more.
hubspot_search_companiesC
Search companies in HubSpot by name, domain, or other properties. Supports advanced filtering with multiple operators.
Inputs: after, limit, query, sorts, +2 more.
hubspot_search_contactsA
Search contacts in HubSpot by email, name, or other properties. Supports advanced filtering with multiple operators.
Inputs: after, limit, query, sorts, +2 more.
hubspot_search_dealsB
Search deals in HubSpot by name, stage, amount, or other properties. Supports advanced filtering with multiple operators.
Inputs: after, limit, query, sorts, +2 more.
hubspot_search_email_engagementsD
Search email engagements in HubSpot.
Inputs: after, limit, query, filters, +1 more.
hubspot_search_meetingsC
Search meeting engagements in HubSpot.
Inputs: after, limit, query, filters, +1 more.
hubspot_search_notesC
Search notes in HubSpot by content or properties.
Inputs: after, limit, query, filters, +1 more.
hubspot_search_tasksD
Search tasks in HubSpot.
Inputs: after, limit, query, filters, +1 more.
hubspot_search_ticketsA
Search tickets in HubSpot by subject, status, or other properties. Supports advanced filtering with multiple operators.
Inputs: after, limit, query, sorts, +2 more.
hubspot_unenroll_contact_from_workflowA
Unenroll a contact (by email address) from a HubSpot workflow.
Inputs: email (required), workflowId (required).
hubspot_update_callC
Update a call engagement's properties.
Inputs: callId (required), body, title, status, +6 more.
hubspot_update_companyB
Update a company's properties in HubSpot.
Inputs: companyId (required), properties (required).
hubspot_update_contactA
Update a contact's properties in HubSpot.
Inputs: contactId (required), properties (required).
hubspot_update_dealC
Update a deal's properties in HubSpot.
Inputs: dealId (required), properties (required).
hubspot_update_email_engagementC
Update an email engagement's properties.
Inputs: emailId (required), body, html, status, +6 more.
hubspot_update_meetingC
Update a meeting engagement's properties.
Inputs: meetingId (required), body, title, endTime, +5 more.
hubspot_update_noteC
Update a note's content or properties.
Inputs: noteId (required), body, ownerId, timestamp.
hubspot_update_taskC
Update a task's properties.
Inputs: taskId (required), body, type, status, +4 more.
hubspot_update_ticketB
Update a ticket's properties in HubSpot.
Inputs: ticketId (required), properties (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 82 tools
Every tool targets a distinct object (contact, company, deal, ticket, note, call, email, meeting, task, workflow, association, property, pipeline, owner) and action (create, read, update, delete, list, search, batch). Even similar operations like 'list' vs 'search' are clearly separated. No ambiguity between tools.
All tools follow a consistent 'hubspot_verb_noun' pattern (e.g., hubspot_create_contact, hubspot_search_deals, hubspot_delete_company). The convention is uniform across all 82 tools, making it predictable for agents. No mixing of styles like camelCase or underscores variations.
82 tools is high for a single server. While HubSpot has a broad API, the tool set could be split into focused servers (e.g., CRM objects, engagements, settings). Some objects have 7-10 tools each, leading to redundancy. The count is borderline appropriate but leans toward excessive.
The tool set comprehensively covers core HubSpot CRM objects (contacts, companies, deals, tickets, notes, calls, emails, meetings, tasks) with full CRUD, search, batch operations, associations, workflows, properties, pipelines, and owners. No significant gaps for typical CRM workflows. Associations and property discovery tools enhance completeness.
Related MCP Connectors
The HubSpot MCP Server acts as a bridge that enables AI assistants and Large Language Models to securely interact with HubSpot CRM data through natural conversation, without requiring users to understand complex API structures. It provides read-only access to standard CRM objects (contacts, companies, deals, tickets, products, invoices, and more) and their associations, secured via OAuth 2.0, allowing AI agents to perform tasks like summarizing deals, fetching company updates, and looking up record changes.
Sales-rep jobs on your HubSpot CRM: daily brief, triage, call prep, forecast. Writes need approval.
Create contacts, move deals, send proposals and invoices, read your inbox, from Claude or ChatGPT.
Personal CRM operated by AI agents. Read relationship context before acting, write back after.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI models to interact with HubSpot CRM data and operations through a standardized interface, supporting contact and company management.16129MIT
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive HubSpot CRM integration through the Model Context Protocol with 15+ tools for managing contacts, companies, and deals. Supports multiple transport protocols (HTTP, SSE, STDIO) with session management and real-time access to CRM data.3MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with HubSpot CRM for managing contacts, companies, deals, and sending emails through natural language commands.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables management of HubSpot CRM entities including contacts, companies, deals, and pipelines through natural language. It provides comprehensive tools for listing, searching, creating, and updating records with support for OAuth 2.0 authentication.MIT