Skip to main content
Glama
HubSpot MCP Server

HubSpot MCP Server

by adeel0x01

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_pipelines for 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_pipelines for 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

  1. Prerequisite:

    • Node.js v18+

    • pnpm v9+

  2. Clone the repository:

git clone https://github.com/adeel0x01/hubspot-mcp-tools.git
cd hubspot-mcp-tools
  1. Install dependencies:

pnpm install
  1. Build the project:

pnpm run build

Testing

pnpm run inspector  # Opens MCP Inspector

Error 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 .env file or expose your HubSpot access token

  • The 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.read and crm.objects.contacts.write

  • crm.objects.companies.read and crm.objects.companies.write

  • crm.objects.deals.read and crm.objects.deals.write

  • tickets (read and write)

  • crm.objects.owners.read

  • crm.schemas.contacts.read

  • crm.schemas.companies.read

  • crm.schemas.deals.read

  • crm.objects.notes.read and crm.objects.notes.write

  • crm.objects.calls.read and crm.objects.calls.write

  • crm.objects.emails.read and crm.objects.emails.write

  • crm.objects.meetings.read and crm.objects.meetings.write

  • crm.objects.tasks.read and crm.objects.tasks.write

  • automation (read and write, for workflow management)

Create a private app:

  1. Go to HubSpot Settings > Integrations > Private Apps

  2. Click "Create a private app"

  3. Add the required scopes listed above

  4. Generate the access token

  5. 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 tools
hubspot_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

    B3.2/5.0

    Scored across 82 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI models to interact with HubSpot CRM data and operations through a standardized interface, supporting contact and company management.
      16
      129
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      3
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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