How to Use the HubSpot Analytics MCP in Google ADK

Q: How do I register the HubSpot Analytics MCP Server inside a Google ADK project?

Use the McpToolset class with your Vinkius HTTP server parameters. Pass the toolset into your LlmAgent constructor under the tools parameter. Your Gemini models will immediately see tools like hsanalyticsviews and hswebanalytics.

Q: How does this server handle large volumes of contact timeline events?

The hslistevents tool gets timeline events for a specific CRM record using its object ID. Because Gemini models in the Google ADK have massive context windows, they can process the entire list of page views and form submissions without hitting token limits.

Feed live HubSpot marketing metrics into your Gemini models using the Google ADK.

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 Google ADK

Create your Vinkius account to connect HubSpot Analytics to Google ADK 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 Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Analyze web traffic inside the Google ADK

`hs_web_analytics` extracts sessions, pageviews, and source breakdowns directly for your Gemini models. The tool processes custom date ranges and periods so your agent can correlate web traffic with your BigQuery datasets. The Google ADK structures these incoming metrics, letting your enterprise agents handle the data within a 1M+ token context window. This means you can feed months of raw traffic trends directly into a single reasoning step.

Expose email performance to Google Cloud agents

`hs_email_analytics` feeds open rates, click counts, bounces, and unsubscribes directly into your agentic workflow. Your agent uses this tool to evaluate specific marketing emails and compare performance across different quarters. Using the Google ADK, you can pass these raw metrics directly to Vertex AI models for deep analysis. The framework connects your email data to your existing Google Cloud infrastructure without custom API glue code.

Query custom reports using this MCP Server

`hs_list_reports` lists all custom analytics reports configured in your portal, including their names, types, and descriptions. This MCP Server tool allows your agent to find exactly which saved report contains the data it needs. The Google ADK lets you restrict tool exposure using the tool names filter if you only want your agent accessing specific reports. This gives you precise control over which HubSpot analytics configurations are visible to your Gemini models.

Setup guide

Set up HubSpot Analytics MCP in Google ADK

Prerequisites

Python 3.10+ installed
google-adk package (pip install google-adk)
Active Vinkius subscription with a valid endpoint token

1

Install Google ADK

Run pip install google-adk to install the Agent Development Kit. MCP support is included via the McpToolset class.
2

Connect via SSE transport

Use McpToolset.from_server() with SseServerParams pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create an LlmAgent

Pass the returned mcp_tools list directly to LlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required.
4

Run with any Gemini model

The agent works with any Gemini model (gemini-2.0-flash, gemini-2.5-pro, etc.). Copy the full example on the right to get started with HubSpot Analytics tools in your ADK agent.

agent.py

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams

# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
    connection_params=SseServerParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    )
)

# Create your agent with auto-discovered tools
agent = LlmAgent(
    name="HubSpot Analytics_agent",
    model="gemini-2.0-flash",
    instruction="You have access to HubSpot Analytics tools via MCP.",
    tools=mcp_tools,
)

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 Google ADK

Use the `McpToolset` class with your Vinkius HTTP server parameters. Pass the toolset into your `LlmAgent` constructor under the tools parameter. Your Gemini models will immediately see tools like `hs_analytics_views` and `hs_web_analytics`.

Yes, because the ADK runs natively in the Google Cloud ecosystem. Your agent can pull web traffic via `hs_web_analytics` and join it with offline sales data stored in BigQuery. This lets you build a complete picture of your marketing funnel.

Yes, the ADK supports both transport protocols. When connecting to Vinkius, you will use the streamable HTTP transport to access your hosted HubSpot tools. The framework manages the connection pool automatically.

The `hs_list_events` tool gets timeline events for a specific CRM record using its object ID. Because Gemini models in the Google ADK have massive context windows, they can process the entire list of page views and form submissions without hitting token limits.

Your web traffic logs and view configurations are protected by sandbox isolation on the Vinkius platform. The Google ADK handles the token exchange directly, keeping your HubSpot API keys completely hidden from the underlying Gemini models.

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