TL;DR: HubSpot was the first CRM to launch an official Claude connector. Today there are three ways to connect Claude to your HubSpot data — the official connector, the HubSpot MCP server, and middleware routing — each suited to different team members and use cases.
This guide covers all three and the specific workflows that deliver the highest return for sales, marketing, and RevOps teams.
Why Claude + HubSpot is a different kind of integration
Most CRM integrations sync data between systems on a schedule. Claude's HubSpot integration works differently. Through MCP (Model Context Protocol), Claude can query, reason over, and act on your live HubSpot data as part of a natural language conversation. You do not need to build a custom report or export a CSV. You describe what you want, and Claude navigates HubSpot on your behalf.
Instead of asking "how do I build a filter for contacts who opened the last campaign but did not click", you simply ask Claude to find them. Instead of pulling pipeline data and writing a leadership summary, Claude pulls it, analyses it, and writes the summary.
Three ways to connect Claude to HubSpot
| Method | Best for | Setup complexity |
|---|---|---|
| Official connector | All HubSpot users, Chat and Cowork | 2 minutes |
| HubSpot MCP server | Claude Code users, full read/write | Moderate |
| Middleware (Composio/n8n) | Multi-tool pipelines | Higher |
Method 1: Official connector — In your Claude account, go to Settings → Search and Tools, toggle HubSpot on, and authenticate. All create/update actions are logged in HubSpot's audit log. Anthropic does not use data shared through the connector to train its models.
Method 2: HubSpot MCP server — For Claude Code users, @hubspot/mcp-server gives full read/write access to contacts, companies, deals, tickets, and engagement history. Requires a HubSpot Private App token configured in claude_desktop_config.json. Run it in a sandbox first.
Method 3: Middleware — For multi-system workflows where Claude needs to pull from HubSpot, enrich via a third-party data source, and push results to Slack or another tool, middleware routers like Composio connect HubSpot alongside hundreds of other apps through a single MCP endpoint.
⚠️ Start with read-only permissions. Test thoroughly. Add write permissions only when you are confident in the output quality.
Workflow 1: Natural language CRM queries
The most immediate value of the Claude–HubSpot connection is replacing complex filter-building with plain English.
Example prompts:
Show me all deals in the negotiation stage that haven't had any activity in the last 10 days, sorted by deal value descending. Which contacts from companies with more than 200 employees opened our last marketing email but haven't been contacted by a rep yet? What's our average deal velocity by lead source for the last 90 days?Workflow 2: Closed-won analysis and ICP refinement
Ask Claude to analyse your last 20 closed-won deals, identify common signals — company size, industry, tech stack, hiring patterns, pain points in sales notes — and distil them into a refined ICP definition. Then search HubSpot for open companies matching the same profile.
Prompt:
Analyse my last 20 closed-won deals in HubSpot. Identify common traits across company size, industry, lead source, deal length, and any patterns in notes or engagement history. Distil these into a refined ICP definition. Then search HubSpot for 15 open companies that match the same profile.Workflow 3: Lookalike outbound agent (Cowork + HubSpot)
Pull call transcripts from HubSpot deals, analyse the pain points and account attributes of closed-won deals, search for similar open accounts, and draft personalised outbound emails for each match — delivered to the GTM team via Slack. A human reviews every email before it sends. The output is close to ready-to-send because it is grounded in real deal data, not generic AI assumptions.
Key principle: Keep a human in the loop on outbound sends. The value is in research and drafting quality — not removing the human decision from the process.
Workflow 4: Pipeline health and forecasting
Connect Claude to your HubSpot pipeline and ask it to produce a weekly forecast narrative — an analysis of pipeline health, at-risk deals, velocity trends, and what the team needs to do to hit the number. Formatted for your leadership audience, not just a raw data export.
Prompt:
Pull our current open pipeline from HubSpot. Produce a pipeline health report covering: 1. Total open pipeline vs our monthly target 2. Deals at risk (no activity in 14+ days, or close date passed) 3. Deals with strong momentum (stage advancement in last 7 days) 4. Forecast: likely close this month based on stage and activity 5. 3 recommended actions for the sales team this week Format for a Monday leadership meeting. Plain English, no jargon.Workflow 5: Campaign performance against CRM outcomes
Ask Claude to correlate HubSpot campaign engagement data with deal outcomes — surfacing which campaigns and channels are actually driving revenue, not just leads.
Workflow 6: Bulk CRM operations and data hygiene (Claude Code)
For RevOps teams comfortable with Claude Code, the HubSpot MCP server unlocks bulk operations: bulk contact enrichment, property normalisation across thousands of records, automated deal stage auditing, and custom scoring logic applied to live CRM data.
Prompt:
Audit all company records in HubSpot for data quality: - Flag records missing Industry, Company Size, or Country - Identify duplicate company names (fuzzy match) - Find contacts not associated with a company - Flag deals with no associated contact Return a summary report and a CSV of records needing action. Do not make any changes — read-only audit only.Workflow 7: Schema-aware content personalisation
Because Claude connected to HubSpot understands your actual contact properties, segment definitions, and lifecycle stages, it can write email copy genuinely tailored to your CRM segments — not generic persona descriptions.
What to watch
The HubSpot connector is still maturing. Not all HubSpot objects are available through the official connector. Always configure Claude to ask for approval before making create or update actions, and use HubSpot's audit log to monitor connector activity. Start small — update one record before running bulk operations.
Frequently asked questions
How do I connect Claude to HubSpot?
In your Claude account, go to Settings → Search and Tools and toggle HubSpot on. Authenticate with your HubSpot credentials. For Claude Code users, the HubSpot MCP server (@hubspot/mcp-server) provides full read/write access via a Private App token in claude_desktop_config.json.
Is it safe to connect Claude to our HubSpot CRM data?
Anthropic does not use data shared through the connector to train its models in most cases. All create and update actions are logged in HubSpot's audit log. Configure the connector to always require approval before making changes and start with read-only permissions.
What can Claude actually do in HubSpot?
With the official connector, Claude can read and query contacts, companies, deals, and tickets in natural language, access full engagement history, and with beta permissions enabled, create and update records. The MCP server gives access to a broader set of tools covering the entire HubSpot platform.
Do I need to know HubSpot's data model to use Claude with it?
No. Claude understands HubSpot's structure and navigates it on your behalf. Giving Claude basic context about your lifecycle stages and key custom properties will produce sharper output, but you do not need to know how to build filters or reports.
Next steps
- See the full Claude stack: The Complete Claude AI Stack
- Set up recurring Cowork workflows: How GTM Teams Can Maximise Claude Cowork
- Build the GTM skills your HubSpot workflows use: 15 Top Claude Skills for GTM Teams
- Integrate with lifecycle marketing: How to Use Claude with Customer.io
About the author
Paul Sullivan is the Founder of ARISE GTM and creator of the ARISE GTM Methodology®. He is the author of Go To Market Uncovered (Wiley, 2025) and host of the GTM Uncovered podcast. ARISE GTM is a HubSpot Platinum Solutions Partner.
- Based: Here East, Queen Elizabeth Olympic Park, London E15 2GW
- Work with ARISE GTM: arisegtm.com/agency-services
- Speak to Paul: arisegtm.com/contact-us
- Podcast: GTM Uncovered on Spotify
- YouTube: @gtmuncovered
Based on ARISE GTM's HubSpot and Claude integration engagements (2024–2026). Current as of April 2026.
%20small.jpg)
