# HubSpot Marketing Hub MCP

> HubSpot Marketing Hub MCP Server connects your AI client to your full HubSpot CRM data. You can search, create, and manage contacts, deals, and support tickets directly from conversation. It gives instant access to your CRM data without ever forcing you to switch tabs. Use it to review lead submissions, check campaign status, or analyze audience list sizes.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** email-campaigns, lead-generation, forms, marketing-lists, campaign-management

## Description

This server plugs your AI client directly into your HubSpot CRM data. You can search, create, and manage contacts, deals, and support tickets from conversation. It gives you instant access to your CRM data without ever forcing you to switch tabs. You can use it to review lead submissions, check campaign status, or analyze audience list sizes.

**Getting Form Submissions**
`hs_form_submissions` gets the individual form submissions for a specific HubSpot form, showing submitted field values and the submission date.

**Listing Marketing Campaigns**
`hs_list_campaigns` lists your marketing campaigns, giving you the name, type, current status, and campaign dates.

**Analyzing Contact Lists**
`hs_list_contact_lists` lists your HubSpot contact lists—whether they're static or smart/dynamic—and shows the name, type, and contact count for each.

**Auditing Lead Capture Forms**
`hs_list_forms` lists all HubSpot forms you use for lead capture, showing their name, type, field count, and total submission volume.

**Reviewing Landing Pages**
`hs_list_landing_pages` lists all your HubSpot landing pages, giving you their title, publish status, URL slug, and the full page URL.

**Checking Email Status**
`hs_list_marketing_emails` lists your marketing emails, detailing their name, subject line, send status, type, and publish date.

## Tools

### hs_form_submissions
Gets individual form submissions for a specific HubSpot form, showing submitted field values and dates.

### hs_list_campaigns
Lists marketing campaigns in HubSpot with name, type, status, and campaign dates.

### hs_list_contact_lists
Lists HubSpot contact lists (static and smart/dynamic) with name, type, and contact count.

### hs_list_forms
Lists HubSpot forms used for lead capture with name, type, field count, and submission volume.

### hs_list_landing_pages
Lists HubSpot landing pages with title, publish status, URL slug, and full page URL.

### hs_list_marketing_emails
Lists marketing emails in HubSpot with name, subject line, send status, type, and publish date.

## Prompt Examples

**Prompt:** 
```
Search for contacts at Acme Corp
```

**Response:** 
```
👥 **Contacts at Acme Corp**
| Name | Email | Phone | Lifecycle |
|---|---|---|---|
| John Smith | john@acme.com | +1 555-0123 | Customer |
| Sarah Chen | sarah@acme.com | +1 555-0456 | Lead |
```

**Prompt:** 
```
Create a deal: Enterprise Package $50,000
```

**Response:** 
```
✅ **Deal Created!**
- Name: Enterprise Package
- Amount: $50,000
- Pipeline: Sales Pipeline
- Stage: Appointment Scheduled
```

**Prompt:** 
```
Show me the deal pipeline stages
```

**Response:** 
```
📊 **Sales Pipeline**
1. Appointment Scheduled
2. Qualified to Buy
3. Presentation Scheduled
4. Decision Maker Bought-In
5. Contract Sent
6. Closed Won ✅
7. Closed Lost ❌
```

## Capabilities

### Retrieve Form Submissions
Gets specific data for a HubSpot form, including submitted field values and the submission date.

### List Marketing Campaigns
Lists marketing initiatives by name, type, current status, and associated dates.

### Analyze Contact Lists
Provides the name, type (static or dynamic), and current count of every contact list in HubSpot.

### Audit Lead Capture Forms
Lists all HubSpot forms, showing their name, type (popup, regular, embedded), field count, and total submissions.

### Review Landing Pages
Lists all standalone landing pages, including their title, publish status, URL slug, and full public URL.

### Check Email Status
Lists all marketing emails, detailing their name, subject line, send status, type, and publish date.

## Use Cases

### The Sales Team Needs a Full Client Picture
A sales rep gets a call from a prospect. They ask their agent, 'What's the history on this account?' The agent runs `hs_list_forms` and `hs_list_contact_lists` to show recent submissions and segmentation status. The rep can then create a deal and immediately add notes to the contact, solving the problem of disjointed client data.

### Marketing Needs to Check Campaign Scope
The marketing manager wants to confirm if the Q3 launch campaign is active. They ask the agent to run `hs_list_campaigns`. The agent returns the name, current status, and dates. This instantly solves the problem of manually searching multiple campaign dashboards to confirm live status.

### Support Team Needs to Track Leads
A support agent needs to know which leads are most engaged. They ask the agent to run `hs_list_forms` and `hs_list_contact_lists`. The agent shows the total submissions for lead forms and the size of the 'High Value Leads' list. This helps the agent prioritize support efforts.

### Reviewing Outdated Content
A content manager needs to know which landing pages are no longer live. They ask the agent to run `hs_list_landing_pages`. The agent returns the title, publish status, and URL slug, allowing the manager to quickly identify and update or archive outdated conversion assets.

## Benefits

- See exactly who submitted a form and what data they gave you using `hs_form_submissions`. You get the field values and the submission date immediately, so you never have to manually check form logs.
- Keep tabs on your marketing efforts. `hs_list_campaigns` shows you the name, type, status, and dates for every single marketing initiative you run.
- Know your audience size at a glance. `hs_list_contact_lists` lists every list in HubSpot, telling you if it's static or dynamic and how many contacts are in it.
- Audit your lead generation setup. `hs_list_forms` lists all your forms, showing their type, how many fields they have, and their total submission volume.
- Review your conversion assets. `hs_list_landing_pages` lists every standalone page, giving you the title, publish status, and the full URL slug for quick checks.
- Track your messaging history. `hs_list_marketing_emails` lists all your emails, giving you the subject line, send status, and whether the email is a draft or published.

## How It Works

The bottom line is, you keep all your HubSpot data visible and actionable without ever leaving your conversation window.

1. You ask your AI agent to find information, like 'What leads did we get from the recent webinar?'
2. The agent calls the appropriate tool, like `hs_form_submissions`, which fetches the raw data from HubSpot.
3. The data gets routed back to your AI client, letting you see the results—the list of submissions, the campaign details, or the contact count—right where you are talking to your agent.

## Frequently Asked Questions

**How do I check lead submissions using the hs_form_submissions tool?**
The `hs_form_submissions` tool gets specific data for a HubSpot form, including submitted field values and the submission date. You must provide the form ID first, and then you can ask the agent to summarize the data for you.

**What is the difference between `hs_list_forms` and `hs_list_contact_lists`?**
`hs_list_forms` lists all forms and their submission volume. `hs_list_contact_lists` lists audience segments (smart or static) and tells you how many contacts are in them.

**Can I see all active marketing campaigns with hs_list_campaigns?**
Yes. `hs_list_campaigns` lists all marketing initiatives, giving you the name, type, current status, and associated dates. It's perfect for auditing your marketing efforts.

**Does HubSpot Marketing Hub MCP Server help with email management?**
Yes. The `hs_list_marketing_emails` tool lists all marketing emails, providing the subject line, send status, type, and publish date, so you can track your messaging history.

**When do I use the `hs_list_contact_lists` tool to manage audience segments?**
Use `hs_list_contact_lists` when you need to know the size and type of your audience segments. It lists all contact lists—both manual (static) and automated (dynamic)—and provides the current contact count for each one. This lets you audit your targeting options before running a campaign.

**How does the server handle rate limits when I run multiple commands like `hs_list_forms`?**
The server manages rate limits automatically. If you exceed the allowed calls, your AI client receives a specific error message detailing the limit reached and when you can try again. This keeps your agent running smoothly without unexpected failures.

**Can I use `hs_list_landing_pages` to check the publishing status of a page?**
Yes, `hs_list_landing_pages` returns the publish status (draft or published) for every page. This lets you quickly verify if a lead capture page is ready to go live or if it's still in draft mode.

**What information does `hs_list_campaigns` provide about a marketing initiative?**
`hs_list_campaigns` gives you the campaign name, its type, current state, and the associated dates. This allows you to get a high-level overview of a marketing effort, seeing which assets (like emails or ads) are part of that single initiative.

**What HubSpot data can I access?**
Contacts, Companies, Deals, Tickets, Notes, Owners, and Pipelines. All data respects your HubSpot permissions.

**Can I create and update records?**
Yes! Create contacts, deals, tickets, and notes. All through natural conversation.

**How does authentication work?**
Uses a HubSpot Private App token (Bearer). Create a Private App in Settings > Integrations > Private Apps, copy the token, and paste it.