HubSpot Local MCP Server: Setup for Claude, Cursor and Other Apps

• Shows which account and scopes the token has

  Checks the token and returns user, hub and scope details.

  Try: “Which HubSpot account and permissions am I using?”

  Network · hubspot-get-user-details

• Searches CRM records with filters

  Searches CRM records using filters on properties.

  Try: “Find deals in the "Decision maker bought in" stage worth over $1,000.”

  Network · hubspot-search-objects

• Lists CRM records of one type

  Returns a page of records for an object type such as contacts or deals.

  Try: “List my recent contacts.”

  Network · hubspot-list-objects

• Reads several records by ID

  Reads many CRM records in one call.

  Try: “Get these five companies by ID.”

  Network · hubspot-batch-read-objects

• Creates several records at once

  Creates many CRM records of one type in one call.

  Try: “Create contacts for these three people.”

  Write · hubspot-batch-create-objects

• Updates several records at once

  Updates many existing CRM records in one call.

  Try: “Update the address for John Smith.”

  Write · hubspot-batch-update-objects

• Lists custom object types

  Returns custom object schemas with their IDs and definitions.

  Try: “What custom objects do we have in HubSpot?”

  Network · hubspot-get-schemas

• Lists the fields on a record type

  Returns the properties defined for a CRM object type.

  Try: “What properties does a deal have?”

  Network · hubspot-list-properties

• Shows one field's details

  Gets the definition of one property.

  Try: “Show the details of the lifecycle stage property.”

  Network · hubspot-get-property

• Adds a custom field

  Creates a custom property for a CRM object type.

  Try: “Add a custom text property "Renewal notes" to companies.”

  Write · hubspot-create-property

• Edits a custom field

  Updates settings on an existing custom property.

  Try: “Rename the "Renewal notes" property.”

  Write · hubspot-update-property

• Shows linked records

  Lists records associated with a given record.

  Try: “List the contacts associated with Acme Inc.”

  Network · hubspot-list-associations

• Lists valid link types between records

  Returns the association types and labels allowed between two object types.

  Try: “What link types exist between contacts and companies?”

  Network · hubspot-get-association-definitions

• Links records together

  Creates many associations between records of different types.

  Try: “Associate John Smith with Acme Inc. as a company.”

  Write · hubspot-batch-create-associations

• Adds a note or task to a record

  Creates a note or task linked to contacts, companies, deals or tickets.

  Try: “Add a task to send a thank-you note to jane@example.com.”

  Write · hubspot-create-engagement

• Reads a note or task

  Gets an engagement by ID.

  Try: “Show me that task.”

  Network · hubspot-get-engagement

• Edits a note or task

  Updates an existing engagement.

  Try: “Move that task to Friday.”

  Write · hubspot-update-engagement

• Lists your workflows

  Returns a page of workflows.

  Try: “List my HubSpot workflows.”

  Network · hubspot-list-workflows

• Shows one workflow

  Gets a workflow with its actions, enrollment rules and schedule.

  Try: “Show me how the onboarding workflow works.”

  Network · hubspot-get-workflow

• Makes a link to a record in HubSpot

  Generates a HubSpot URL that opens a record in the app.

  Try: “Give me a link to the Acme Inc. company record.”

  Read · hubspot-get-link

• Makes a link for tool feedback

  Generates a link for reporting issues with the tools.

  Try: “I want to send feedback on these tools.”

  Read · hubspot-generate-feedback-link

Watch out for

• It can change real customer records

  Batch tools can update many contacts, companies or deals at once. Check the plan before you approve a batch.

• It can create and edit custom properties

  Property tools change your CRM schema, which affects forms and reports. Leave those scopes off if you do not need them.

• It is a beta

  The README says the server is in beta and subject to HubSpot's Early Adopter Program terms.

Security advisories