How to Use the HubSpot Marketing Hub MCP in Windsurf

Q: Does this work with dynamic contact lists?

Yes. The hslistcontactlists tool returns both STATIC and DYNAMIC lists. You'll see the name, type, and current contact count for every list in your account.

Instantly query your HubSpot marketing assets without leaving your IDE. Windsurf connects the dots for you.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HubSpot Marketing Hub MCP to Windsurf

Create your Vinkius account to connect HubSpot Marketing Hub 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 Marketing Hub with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Find Any HubSpot Asset, Instantly

Stop digging through the HubSpot UI. Just ask Windsurf to find what you need. It can pull up all your marketing emails with `hs_list_marketing_emails` or give you a full inventory of your landing pages using `hs_list_landing_pages`. You get the critical details right in your editor—names, statuses, and URLs. It's the fastest way to check if that new page is live or what the subject line was on last week's email blast.

Autonomous Workflows with this MCP Server

This is where Windsurf's Cascade agent really shines. Tell it, "Check the submissions for the 'Q3 Webinar' form." Cascade knows it needs to find the form ID first with `hs_list_forms`, then feed that ID into `hs_form_submissions` to get the data. It does all this in the background, without you prompting each step. You set the goal, and Cascade chains the tools together to get you the answer. This is what makes this HubSpot MCP server so useful.

Get a Handle on Campaigns and Lists

Get a quick snapshot of your marketing efforts. Ask Windsurf to show you active campaigns with `hs_list_campaigns` to see what's running, or use `hs_list_contact_lists` to check the size of your audience segments. This gives you immediate insight into campaign status and audience counts without having to build a report. It’s perfect for those quick status checks during a stand-up or planning session.

Setup guide

Set up HubSpot Marketing Hub 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 Marketing Hub 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 Marketing Hub payment history." If connected, Cascade will call the HubSpot Marketing Hub tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "hubspot-marketing-hub-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 Marketing Hub 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 Marketing Hub MCP in Windsurf

Just tell Windsurf's Cascade agent to get submissions for a form by name. It will automatically use `hs_list_forms` to find the ID and then `hs_form_submissions` to fetch the data.

No, this MCP server provides read-only access. You can list assets with tools like `hs_list_campaigns` and `hs_list_forms`, but you can't create or edit them.

Simply ask Windsurf, "Show me all active campaigns." It will use the `hs_list_campaigns` tool to pull a list with their names, types, and current status right into your editor.

Yes. The `hs_list_contact_lists` tool returns both STATIC and DYNAMIC lists. You'll see the name, type, and current contact count for every list in your account.

The server only reads metadata about your marketing assets. It fetches things like campaign names, email subject lines, form submission data, and contact list counts. All connections are ephemeral and proxied through Vinkius's zero-trust sandbox.

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