# HubSpot Analytics MCP

> HubSpot Analytics MCP instantly connects your AI agent to HubSpot's full data stack, letting you analyze web performance, track email campaign success, and review detailed CRM records without leaving your client. Get real-time reports on traffic sources, contact activity timelines, and deal pipeline status through natural conversation.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** web-analytics, campaign-tracking, marketing-reports, data-visualization, inbound-marketing

## Description

This MCP gives your AI client direct access to your HubSpot data—everything from website traffic metrics to the deep history of individual contacts. Instead of jumping between tabs or running complex API calls, you simply ask about what you need. You can check how an email campaign performed by pulling open rates and bounce counts, or instantly summarize every interaction a company has had with your sales team. It's like having a single pane of glass for all your marketing and sales data. Since Vinkius manages this connection, you get reliable access to the entire HubSpot catalog right where you work. You can search contacts by name or domain, track which deals are stalled in the pipeline, or even list every custom report available to audit your metrics.

## Tools

### hs_analytics_views
This tool lists all available reporting scopes in your account, letting you filter web traffic and reports by the correct view ID.

### hs_email_analytics
It gets detailed performance metrics for a specific marketing email send, including open rates, click counts, bounces, and unsubscribes.

### hs_web_analytics
You pull website traffic data over time, getting sessions, pageviews, new contacts generated, and source breakdowns.

### hs_list_reports
This tool lists every custom or auto-generated analytics report configured in your HubSpot account by name and description.

### hs_list_events
It generates an activity timeline for a specific record, showing all interactions like calls, forms, or meetings that have happened.

## 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

### Review website performance and lead generation
You get total sessions, page views, bounce rates, and new contact counts directly from web traffic data.

### Audit email campaign results
The system pulls key metrics like open rate, click count, bounces, and unsubscribe totals for specific marketing sends.

### Track full customer activity history
You can generate a timeline of all interactions—including form submissions, calls, or meetings—for any single contact or company record.

### Manage and discover CRM records
The agent lets you search for contacts, find related companies by domain, or even create new support tickets on the fly.

### Understand sales pipeline status
You can list all possible deal stages and track specific deals, including their current value and owner assignments.

## Use Cases

### Reviewing a stalled deal's full history
A sales rep needs to know why Deal XYZ hasn't moved in two weeks. Instead of opening the CRM and scrolling, they ask their agent to run `hs_list_events` on that deal ID. The agent immediately lists every note, call, or meeting attached to it.

### Comparing web performance against marketing efforts
A marketing manager needs to prove the value of a new landing page. They ask their agent to run `hs_web_analytics` for traffic trends and then compare that data using `hs_email_analytics` metrics from the associated campaign.

### Onboarding a new support team member
A manager needs quick visibility into user activity. They use the MCP to search contacts, find related companies by domain, and check all available pipeline stages using `hs_list_reports` before training the new employee.

### Auditing reporting capabilities
A RevOps team member needs to know if a niche report exists. Instead of guessing or asking an admin, they run `hs_list_reports` and get a comprehensive list of every custom analytics report available in the system.

## Benefits

- Stop switching tabs to compare metrics. You can ask your agent for the `hs_web_analytics` results alongside `hs_email_analytics` in one prompt, getting a unified view of performance.
- You never have to manually audit reports again. Just use `hs_list_reports` to see every custom report configured in HubSpot and know exactly what data is available.
- Context switching ends now. Instead of opening the CRM just to check activity, you ask for it using `hs_list_events`, which instantly pulls the full history for any contact or deal.
- Get a single source of truth for sales visibility. The MCP lets you search and manage contacts, companies, and deals without leaving your chat interface.
- Understand campaign ROI quickly. Use `hs_email_analytics` to get immediate numbers on open rates and bounces, helping you decide which campaigns need fixing.

## How It Works

The bottom line is that your AI client handles all the API calls and dashboard navigation; you just talk to it like normal.

1. Tell your AI client what data you need to see (e.g., 'Show me the web traffic for last week').
2. The MCP interprets the request, routes it through the correct HubSpot tool, and pulls the raw data.
3. Your agent processes the metrics—like sessions or open rates—and presents a clean summary back to you.

## Frequently Asked Questions

**How do I check my web traffic using HubSpot Analytics MCP?**
You use `hs_web_analytics`. Simply ask your agent for website traffic data, and specify the time period you're interested in. It pulls metrics like sessions, pageviews, and new leads directly.

**Can I see email performance using HubSpot Analytics MCP?**
Yes, use `hs_email_analytics`. You give it the campaign details, and it returns key stats like open rates, click counts, and bounce numbers for you to review.

**What is the difference between listing reports and viewing analytics?**
`hs_list_reports` only lists *what* reports exist in your account. To actually view the data (like sessions or leads), you need to use `hs_web_analytics` or a similar reporting tool.

**How do I track all activity for one company record?**
Run the `hs_list_events` tool. You provide the Company ID, and it gathers every interaction—from notes to form submissions—into a single, readable timeline.

**Does HubSpot Analytics MCP help with deal pipeline tracking?**
Yes. The MCP allows you to search for deals, view their current stage, and list all possible stages in the sales pipeline using dedicated tools.