How to Use the HubSpot Analytics MCP in Windsurf

Q: Is my HubSpot contact activity data secure with Windsurf?

Yes, your data is secure. When Windsurf uses hslistevents to fetch a contact's activity timeline, the data streams directly to your client over a TLS-encrypted connection. Vinkius servers process the request in an ephemeral sandbox and don't store your HubSpot data.

Let Windsurf's Cascade agent dig into your HubSpot data so you don't have to. Set a goal, and it delivers the full report.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HubSpot Analytics MCP to Windsurf

Create your Vinkius account to connect HubSpot Analytics to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup HubSpot Analytics with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get a Full Funnel View, Autonomously

Stop pulling reports manually. Just ask Windsurf to check on a prospect and its Cascade agent gets to work. It can find a contact, pull their entire history with `hs_list_events`, and give you a summary of every page view, email open, and form submission. You get the full picture of a lead's engagement without ever leaving your editor. This isn't just about fetching one piece of data; it's about your agent understanding the whole story and presenting it to you.

Find Your Best and Worst Marketing Emails

Ask Windsurf, “Which email campaigns are actually working?” Cascade can start by getting a list of your reports with `hs_list_reports`, then run `hs_email_analytics` on the relevant campaigns to find the winners and losers. It does the whole sequence on its own. Instead of you running five different queries, you give one high-level command. Cascade chains the tools together to compare open rates, click rates, and bounce counts, then gives you a straight answer. Now you know where to focus your effort.

Connect Windsurf to Your HubSpot Analytics MCP Server

You don't need to guess which metrics matter. Tell Windsurf to check last week's website performance. The Cascade agent uses `hs_web_analytics` to pull sessions, new contacts, and bounce rates for the exact period you asked for. This MCP Server gives your agent direct access to the numbers. You can ask for trends daily, weekly, or monthly. It's the difference between guessing and knowing, right inside your IDE.

Setup guide

Set up HubSpot Analytics MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the HubSpot Analytics MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my HubSpot Analytics payment history." If connected, Cascade will call the HubSpot Analytics tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "hubspot-analytics-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by HubSpot. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect HubSpot Analytics now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about HubSpot Analytics MCP in Windsurf

You give Windsurf a high-level goal, like "find my best performing email this month." Its Cascade agent uses tools like `hs_list_reports` to find campaigns and `hs_email_analytics` to get the open and click rates, then presents a summary.

Yes. Ask Windsurf for a weekly summary and its agent uses the `hs_web_analytics` tool to get session and new contact data for that period. It handles figuring out the dates and parameters for you.

The fastest way is through the built-in MCP Marketplace in Windsurf. Find the HubSpot Analytics server and click to install. You can also add it manually in your `mcp_config.json` file if you prefer.

Windsurf's Cascade agent analyzes your request and plans a multi-step sequence. If you ask for a contact's history, it knows to use `hs_list_events`. If you ask about site traffic, it selects `hs_web_analytics` automatically.

Yes, your data is secure. When Windsurf uses `hs_list_events` to fetch a contact's activity timeline, the data streams directly to your client over a TLS-encrypted connection. Vinkius servers process the request in an ephemeral sandbox and don't store your HubSpot data.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript