HubSpot MCP, HubSpot's official hosted MCP server

• Finds CRM records with filters and text search

  Searches contacts, companies, deals and other CRM records using filter groups, text queries, sorting and paging, up to 200 results a page. Use it to find the records that match a condition.

  Try: “Find all open deals over $50,000 closing this quarter”

  Network · search_crm_objects

• Fetches specific CRM records by ID

  Fetches up to 100 CRM records by their IDs in one request. Use it when you already know which records you want.

  Try: “Get the details for contacts 101, 102 and 103”

  Network · get_crm_objects

• Answers aggregate questions with SQL over your CRM

  Runs SQL with HubSpot extensions for filtering, aggregating and sorting CRM data. It does not support joins or subqueries. Use it for totals and counts across records.

  Try: “How many deals did we close per owner last month?”

  Network · query_crm_data

• Creates or updates CRM records and activities

  Creates or updates records and activities such as calls, emails, meetings, notes and tasks. It shows a summary of proposed changes and needs your confirmation before writing. Use it for data entry.

  Try: “Create a contact for Sam Lee at Acme and log a note about today's call”

  Write · manage_crm_objects

• Creates segments and edits their members

  Creates static and dynamic segments, and adds or removes records from static ones. It needs your confirmation before each write. Use it to build lists for campaigns.

  Try: “Create a static segment of contacts from the Berlin event”

  Write · manage_segment

• Finds record owners by name or email

  Looks up CRM record owners by name, email or ID, up to 100 results. Use it to find who owns an account before assigning or filtering.

  Try: “Who owns the Acme account?”

  Network · search_owners

• Searches inbox conversations and messages

  Searches conversations by CRM object, time range or keyword and can summarize by channel, inbox or status. Use it to find customer messages.

  Try: “Find conversations from this week mentioning refunds”

  Network · search_conversations

• Finds buyer intent signals for companies and contacts

  Searches intent signal records, lists the account's signal types and counts signals by company. Use it to see which accounts are showing buying interest.

  Try: “Which companies showed the most intent signals this month?”

  Network · search_intent_signals

• Reads campaign analytics and asset metrics

  Reads campaign analytics, asset metrics or contact data in a single operation. Use it to see how a campaign performed.

  Try: “Show the performance of the spring launch campaign”

  Network · read_campaign_data

• Shows revenue and deals credited to campaigns

  Returns revenue and deal attribution for campaigns, limited to closed-won deals. Use it to see which campaigns brought in revenue.

  Try: “Which campaigns drove the most closed-won revenue?”

  Network · get_campaign_attribution_reports

• Creates or updates campaigns and their assets

  Creates or updates marketing campaigns and manages which assets are linked to them. It needs your confirmation first. Use it to set up a campaign.

  Try: “Create a campaign called Fall Webinar Series”

  Write · manage_campaign_objects

• Shows send, open and click stats for marketing emails

  Returns email analytics for sends in a date range: account totals, email health diagnostics by MX group, or per-contact delivery and engagement for one send. Use it to review email performance.

  Try: “How did last week's newsletter perform?”

  Network · get_marketing_email_analytics

• Lists, drafts, edits and previews marketing emails

  Lists templates, subscription types and from addresses, creates, updates and clones email drafts, edits and previews content and manages A/B variants. Use it to build emails.

  Try: “Draft a product update email from our latest template”

  Write · manage_marketing_email

• Shows traffic and conversions for pages and blog posts

  Runs analytics across landing pages, website pages and blog posts, with totals, time series and viewer lookups. Use it to see which content performs.

  Try: “Which landing pages converted best this quarter?”

  Network · get_content_analytics_report

• Builds, edits and publishes landing pages

  Creates, edits, styles, publishes, clones and inspects landing pages. It asks for confirmation before creating from a template, publishing or restoring a revision. Use it to build a page.

  Try: “Create a landing page from the webinar template”

  Write · manage_landing_page

• Edits website pages and site navigation

  Creates, edits, styles, publishes and clones website pages and edits navigation menus. It asks for confirmation before publishing or changing navigation. Use it to maintain your site.

  Try: “Add a link to the pricing page in the main navigation”

  Write · manage_website_page

• Lists, writes and publishes blog posts

  Lists blogs, posts and tags, reads post content and writes the body, metadata, author and tags. New posts start as drafts and publishing needs confirmation. Use it for blogging.

  Try: “Draft a blog post on our new feature”

  Write · manage_blog_post

• Gets full property definitions

  Returns full property definitions, including data types and allowed values. Responses can be large, so ask for specific properties. Use it to learn what values a field accepts.

  Try: “Show the allowed values for the deal stage property”

  Network · get_properties

• Creates custom CRM properties

  Creates new custom properties on CRM objects. Use it when you need a field that does not exist yet.

  Try: “Add a custom contact property for preferred language”

  Write · manage_custom_properties

• Creates and edits pipelines

  Creates and manages pipelines for supported objects. On accounts with free tools it can only edit the default pipeline. Use it to change deal or ticket stages.

  Try: “Add a Negotiation stage to our sales pipeline”

  Write · manage_custom_pipelines

• Shows who you are connected as and what you can do

  Returns the signed-in user, account details and read and write access per object. Run it after connecting to see which tools and objects are available to you.

  Try: “Show my HubSpot user details and permissions”

  Network · get_user_details

• Shows your organization's teams, seats and settings

  Returns teams, job titles, seat counts and account details such as timezone, currency and account type. Use it for account administration questions.

  Try: “How many seats and teams does our HubSpot account have?”

  Network · get_organization_details

• Shows how your brand appears in AI answers

  Returns brand-level answer engine optimization analytics, including share of voice, prompt trends and competitor comparisons. It needs Marketing Hub Professional or Enterprise. Use it to track AI visibility.

  Try: “What is our share of voice in AI answers?”

  Network · get_aeo_metrics

• Views and adds tracked AI prompts

  Shows tracked prompts and their performance, including full responses from ChatGPT, Gemini, Perplexity and Claude, and can create new tracked prompts. It needs Marketing Hub Professional or Enterprise.

  Try: “Add a tracked prompt about best CRM for startups”

  Write · manage_aeo_prompts

• Reviews brand recommendations and acts on them

  Lists brand recommendations and can start actions such as generating blog or social posts, after your confirmation. It needs Marketing Hub Professional or Enterprise.

  Try: “Show the AI visibility recommendations and start the top one”

  Write · manage_aeo_recommendations

• Guides CRM onboarding steps

  Assesses where the account stands in CRM onboarding and walks through steps such as goal setting and tasks. Use it when setting up a new account.

  Try: “Help me finish setting up my HubSpot CRM”

  Write · manage_onboarding

• Used by the assistant behind the scenes

  Lists inboxes and channels in your account

  Lists the inboxes, channels and channel instances in the account. Call it before filtering conversation searches by channel or inbox.

  Try: “List the inboxes and channels in our account”

  Network · get_conversation_channel_metadata

• Shows a preview card of a page or post

  Displays a read-only preview of a landing page, website page or blog post after its final edit or publish. Use it to check the result.

  Try: “Show me a preview of the landing page we just edited”

  Read · render_asset

• Finds property names by keyword

  Searches the property definitions of an object type by keyword and returns names, labels and descriptions, up to five keywords per request. Use it to find the right field name.

  Try: “What is the property for lead source on contacts?”

  Network · search_properties

• Finds which object types exist and what you can access

  Searches the HubSpot schema for available object types and returns each type's read and write access based on your permissions. Use it to learn what is in the account.

  Try: “Which CRM object types can I read and write?”

  Network · discover_hubspot_schema

• Looks up usage tips for other HubSpot tools

  Returns instructions on how to use one or more HubSpot tools, including inputs, outputs and how they work together. The assistant uses it before complex calls.

  Try: “Explain how to use the CRM query tool”

  Read · tool_guidance

• Sends feedback about the HubSpot MCP server

  Sends feedback about the server experience to HubSpot.

  Try: “Send feedback to HubSpot that search was slow”

  Write · submit_feedback

Watch out for

• It can create and update CRM records and pages

  It can change contacts, deals, tickets, activities, pages, blog posts and campaigns, but cannot delete anything. Set write tools to Needs Approval; the Claude and ChatGPT connectors also stop bulk changes at 10 records. knowledge.hubspot.com

• ChatGPT writes skip your custom validation rules

  HubSpot says pipeline stage and association label rules are not applied to ChatGPT connector writes, so bad data can get past rules your team set. Check each change before you approve it. knowledge.hubspot.com

• It only reaches what your HubSpot role allows

  Users see or edit only records their HubSpot permissions allow. A Super Admin must approve the connector before most people can connect. developers.hubspot.com

• Sensitive Data hides calls, emails and notes from it

  If Sensitive Data is on, calls, emails, meetings, notes, tasks and conversations are hidden from the server, and sensitive properties are never exposed. developers.hubspot.com

• Changes are logged in the HubSpot Audit Log

  Creates and updates made through the ChatGPT connector show under both the user and the connector. developers.hubspot.com

Security advisories

In their words