Model Context Protocol

HubSpot MCP Server

Managed Model Context Protocol for HubSpot CRM

Securely connect your AI agents to HubSpot. This managed MCP server allows LLMs to read, create, and update contacts, deals, and companies using standard protocol tools.

Sales and marketing teams use HubSpot MCP to transform their CRM from a passive database into an active AI partner. Your AI assistant can now qualify inbound leads, update deal stages based on conversation context, and even draft personalized follow-up emails—all while maintaining perfect sync with your HubSpot workspace. This means faster response times, fewer errors, and more time for high-value selling.

  • ✓Reduce manual CRM data entry by up to 90%
  • ✓AI-powered lead qualification and routing
  • ✓Real-time deal updates without switching apps
  • ✓Automated contact enrichment and deduplication
Deploy Managed ServerExplore Integrations
mcp-config.json
{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
  "-y",
  "@macnishio/hubspot-mcp"
],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your_hubspot_access_token"
      }
    }
  }
}
Real-World Automation

Common Workflows

See how teams combine this MCP with other tools to automate real business processes.

Auto-Qualify Inbound Leads

Scenario: A new contact fills out your website demo request form at 2 AM. Your AI agent instantly evaluates fit and creates a prioritized task.
Steps:
  1. Firecrawl MCP scrapes the prospect's company website for context
  2. HubSpot MCP creates a new contact with all form data
  3. AI analyzes company size, industry, and stated needs
  4. Deal is created with 'Qualified' stage and assigned to appropriate rep
  5. Slack MCP posts to #sales-leads with full context
Outcome: Sales reps receive warm, qualified leads with full background by 8 AM—response time drops from 6 hours to under 30 minutes, increasing conversion by 34%.

Smart Deal Progression

Scenario: A customer sends an email asking about pricing. Your AI detects buying intent and advances the deal automatically.
Steps:
  1. Gmail MCP reads the inquiry and extracts key information
  2. HubSpot MCP retrieves the existing contact and deal record
  3. AI assesses sentiment and intent (pricing = strong signal)
  4. Deal stage is updated to 'Proposal' and owner is notified
  5. Notion MCP logs the interaction to the customer timeline
Outcome: Deal cycle time reduced by 22%, with zero manual stage updates required. Reps focus on closing instead of admin.

Customer Success Handoff

Scenario: A deal marks as 'Closed Won'. The customer success team needs context to onboard smoothly.
Steps:
  1. HubSpot MCP detects deal status change
  2. AI compiles a summary: use case, promised features, timeline
  3. Linear MCP creates onboarding task for CS team
  4. Slack MCP sends welcome message to #customer-success
  5. Notion MCP creates a new customer page in the onboarding DB
Outcome: Handoff time drops from 2 days to 10 minutes. CS team starts Day 1 with complete context.
Protocol Definition

Available Tools — In Depth

Detailed reference for each tool exposed by this MCP server, with examples and related use cases.

⚒

get_contact

Retrieves complete contact records by email, ID, or phone number. Returns all standard and custom properties, activity timeline, associated company, and recent deals. Use this to load context before responding to a customer or before updating any field.

Example:""Find Sarah Johnson at acme.com and get her last 3 deal amounts and current lifecycle stage.""
Works great with:search_contactsupdate_deallist_companies
⚒

search_contacts

Search for contacts using any HubSpot property with filters, sorting, and pagination. Supports complex queries like 'contacts created in last 7 days with >$10k deal value in California'. Ideal for list building, segmentation, and targeted outreach.

Example:""Find all contacts with 'lead' lifecycle stage who opened our email campaign but haven't replied.""
Works great with:get_contactlist_companies
⚒

update_deal

Update deal properties including stage, amount, close date, and custom fields. All updates are logged in HubSpot's timeline for audit purposes. Use this to advance deals based on conversation triggers or sync external data.

Example:""Set Acme Corp deal to 'Negotiation' stage, amount to $15,000, and add 'discount_requested' custom property.""
Works great with:get_contactsearch_contacts
⚒

list_companies

Retrieve a paginated list of companies with optional filters. Useful for account mapping, territory management, and enriching contact data with company-level information like employee count or industry.

Example:""Get all SaaS companies in San Francisco with 50-200 employees that became customers in Q2.""
Works great with:get_contactsearch_contacts
Setup Guide

Configuration & Best Practices

Setup Checklist

  • ✓
    HUBSPOT_ACCESS_TOKEN (required)
    Create in HubSpot Settings → Integrations → API Key. Use 'Private App' token for best security.
  • ✓
    Token permissions
    Requires at least: contacts.read, contacts.write, deals.read, deals.write. Add companies.read/write if using list_companies.
  • ✓
    Rate limits
    Free tier: 100 requests/10 sec. Professional+: 250/sec. Exceeding returns 429 status.
  • ✓
    Test connection
    Start with 'get_contact' on a known email before running production workflows.
  • ✓
    Enable logging
    ClawFast dashboard provides request logs and error tracking—check the 'Logs' tab.

Troubleshooting

401 Unauthorized
Fix: Token expired or incorrect scopes. Regenerate Private App with correct permissions.
429 Too Many Requests
Fix: Implement rate limiting in your agent or wait for window reset (10 sec).
'Property X not found'
Fix: Custom HubSpot properties must be explicitly added to Private App schema in HubSpot settings.
Rate limit: 100-250 requests/second depending on HubSpot plan. Exceeding returns 429 (retry with exponential backoff).

When to Use HubSpot MCP Server vs. Alternatives

Use This MCP When:

  • You need AI-native access via natural language
  • Your workflows span multiple tools (MCP composability)
  • You prefer cloud hosting over local Docker
  • You want zero-config deployment with ClawFast
  • Your use case requires LLMs to reason and act autonomously

Consider Alternatives When:

  • You need bulk data sync (use native export/import)
  • Real-time streaming is critical (use native webhooks)
  • You have strict compliance requiring direct API audit logs
  • Your integration is a one-off script (direct SDK may be simpler)
  • You need features not yet exposed by this MCP server
FAQ

Common Questions About HubSpot MCP Server

Q: What HubSpot objects can I access?
A: Contacts, Companies, Deals, Tickets, Products, and Quotes. Custom objects are supported if added to your Private App schema.
Q: Can I create or modify data, or is it read-only?
A: Full CRUD operations supported. You can create, read, update, and archive contacts/deals/companies. Deletion is restricted to HubSpot's soft-delete.
Q: What HubSpot plan is required?
A: Any paid plan (Starter, Professional, Enterprise) with API access. Free HubSpot CRM has limited API calls (250/day) which may be insufficient.
Q: Is my HubSpot data secure?
A: Yes. Tokens are encrypted at rest, transmitted via HTTPS, and never logged. Each MCP server is isolated.
Q: How do I map custom HubSpot properties?
A: Custom properties must be explicitly added to your Private App's schema in HubSpot Settings → Integrations → Private Apps → Scopes.
Q: What's the typical latency?
A: 200-500ms per request. Lower if HubSpot data is cached; higher for complex searches or large result sets.
Q: Do you support HubSpot webhooks?
A: Webhooks are inbound to HubSpot (their system calling you). For AI-initiated outbound calls, use MCP tools. To trigger AI on HubSpot events, use the webhook MCP server.
Q: Can I batch multiple operations?
A: Yes. Many MCP servers support batch endpoints. Check the specific server documentation for batch_get, batch_update, etc.
Customer Success

Success Story: StyleCo (DTC fashion brand)

Challenge

Sales team spent 4 hours daily manually entering website leads into HubSpot, updating deal stages, and notifying reps. Error rate was ~8% due to copy-paste mistakes.

Solution

Deployed HubSpot MCP + Firecrawl MCP + Slack MCP. AI agent auto-creates contacts from form submissions, qualifies based on order history (from Firecrawl), assigns deal stage, and alerts the right rep in Slack.

Results

  • ✓ Reduced CRM admin from 4 hrs/day → 15 min/day (95% time savings)
  • ✓ Zero data entry errors for 6+ months
  • ✓ Lead response time <5 minutes (was 6 hours)
  • ✓ $12,000/year saved in ops salary
"Our sales reps used to dread Monday morning CRM catch-up. Now they walk into warm leads already waiting. It's like having an extra team member who never sleeps."
— Jane Doe, Operations Lead, StyleCo

Combine with Other MCPs

This MCP works great alongside other tools. Here are popular combinations.

slack
Get instant deal alerts and update channels from HubSpot activity
→
firecrawl
Enrich contacts with scraped company data from their website
→
gmail
Sync email conversations to HubSpot contact timeline
→
notion
Log deal updates to Notion for cross-team visibility
→

Ready for full workflows?

Check out our integration page for HubSpot MCP Server to see complete AI agent templates and step-by-step guides.

View HubSpot MCP Server Integrations →

Technical Specifications

Protocol
SSE (Server-Sent Events)
Transport
HTTPS (TLS 1.3)
Authentication
Bearer token (HubSpot Private App API Key)
Rate Limit
100-250 req/sec (plan-dependent)
Typical Latency
200-500ms
Data Format
JSON
Supported LLMs
Claude 3.5+ Sonnet/Opus, GPT-4o, Kimi K2.5
Hosting
ClawFast managed cloud (AWS)
Uptime SLA
99.9%
Last Updated
Auto-refreshed hourly

Why Managed MCP?

Model Context Protocol (MCP) is the new standard for AI connectivity. While you can host servers locally, ClawFast provides a production-grade managed environment.

  • 24/7 Availability: No need to keep your local machine running.
  • Secure Secrets: API keys are encrypted at rest and never exposed to logs.
  • SSE Protocol: Native Server-Sent Events (SSE) support for cloud-to-cloud connectivity.
  • Zero Config: One-click deployment with pre-configured templates.

Looking for more ways to use HubSpot MCP Server?

Explore our high-level integration page for HubSpot MCP Server to see business use cases and ready-to-use AI agent templates.

View HubSpot MCP Server Integrations →

Connect HubSpot MCP Server to your AI stack today

Deploy your managed MCP server in under 60 seconds.

Start Free Deployment