HubSpot MCP server for AI agents

Search and manage CRM contacts, companies, deals and notes in HubSpot.

Auth
Access token · OAuth 2.0 (sign in with the app)
Tools
15
Triggers
0
Category
CRM

Tools and triggers

  • List contacts

    HUBSPOT_LIST_CONTACTS

    Lists contacts in the CRM, oldest first, with the requested properties. Page with the `after` cursor.read-only

  • Search contacts

    HUBSPOT_SEARCH_CONTACTS

    Finds contacts by a free-text query and/or property filters.read-only

  • Create a contact

    HUBSPOT_CREATE_CONTACT

    Creates a contact from property values, e.g. { "email": "jane@example.com", "firstname": "Jane", "lastname": "Doe" }.

  • Update a contact

    HUBSPOT_UPDATE_CONTACT

    Changes properties of an existing contact. Only the properties given are changed.

  • List companies

    HUBSPOT_LIST_COMPANIES

    Lists companies in the CRM, oldest first, with the requested properties. Page with the `after` cursor.read-only

  • Search companies

    HUBSPOT_SEARCH_COMPANIES

    Finds companies by a free-text query and/or property filters.read-only

  • Create a company

    HUBSPOT_CREATE_COMPANY

    Creates a company from property values, e.g. { "name": "Acme", "domain": "acme.com" }.

  • Update a company

    HUBSPOT_UPDATE_COMPANY

    Changes properties of an existing company. Only the properties given are changed.

  • List deals

    HUBSPOT_LIST_DEALS

    Lists deals in the CRM, oldest first, with the requested properties. Page with the `after` cursor.read-only

  • Search deals

    HUBSPOT_SEARCH_DEALS

    Finds deals by a free-text query and/or property filters.read-only

  • Create a deal

    HUBSPOT_CREATE_DEAL

    Creates a deal from property values, e.g. { "dealname": "Acme renewal", "amount": "5000", "dealstage": "appointmentscheduled", "pipeline": "default" }.

  • Update a deal

    HUBSPOT_UPDATE_DEAL

    Changes properties of an existing deal. Only the properties given are changed.

  • Get a CRM record

    HUBSPOT_GET_OBJECT

    Returns one contact, company, deal or note by id with the requested properties.read-only

  • Add a note to a contact

    HUBSPOT_CREATE_NOTE

    Logs a note on a contact's timeline, optionally also linked to a company and a deal.

  • List owners

    HUBSPOT_LIST_OWNERS

    Lists the HubSpot users that can own records, with their ids and emails. Needed to assign owners.read-only

Connect via MCP

Create an MCP server for HubSpot in the dashboard, then add its URL to your client. This is the Claude Code command; the client guide has the others.

terminal
claude mcp add --transport http hubspot \
  "https://www.prompt-tm.com/mcp/<server id>?user_id=<your user>" \
  --header "x-api-key: ptm_…"

Connect via REST

Run a tool with one request. The response is { data, error, successful, log_id } for every tool.

terminal
curl -X POST https://www.prompt-tm.com/api/v3/tools/execute/HUBSPOT_LIST_CONTACTS \
  -H "x-api-key: $PROMPT_TM_KEY" -H "content-type: application/json" \
  -d '{ "user_id": "alice", "arguments": {} }'

HubSpot questions

Other toolkits