How to Use the Google Analytics MCP in CrewAI

Q: How do I connect the Google Analytics MCP Server to a CrewAI agent?

Install crewaitools and add the server's HTTP endpoint to the mcps list of your Agent configuration. This instantly exposes all 12 GA4 tools to that specific agent.

Q: Can I limit which Google Analytics tools a CrewAI agent can access?

Yes, use the MCPServerHTTP class from crewai.mcp and define a toolfilter. This lets you restrict a copywriter agent to getmetadata while giving your analyst agent full access to runreport.

Q: How does CrewAI handle complex GA4 dimension combinations?

Your planning agent can run checkcompatibility before executing a report query. This prevents the crew from getting stuck in loops trying to run invalid dimension and metric pairings.

Q: Can a CrewAI team export Google Analytics audiences autonomously?

Yes, an operator agent can trigger jobs with listaudienceexports and monitor them using getaudienceexport. Once complete, the agent can hand the user list over to an email marketing agent.

Q: Is my Google Analytics user activity data safe with CrewAI?

Absolutely, because all data processed by the getuseractivity tool remains within your local runtime environment. The Vinkius MCP server uses ephemeral execution, meaning no personal user identifiers are saved or stored.

Deploy specialized AI crews to analyze Google Analytics data autonomously with CrewAI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Google Analytics MCP to CrewAI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-agent property mapping in CrewAI

The `list_accounts` tool gives your research agent a starting point by listing all accessible analytics accounts. From there, a specialized analyst agent uses `list_properties` to map out every active website stream in the portfolio. This collaborative approach uses CrewAI's shared memory to pass property details between agents. You simply pass the server URL in the `mcps` array to give your entire crew access to this MCP Server.

Automated funnel auditing using this MCP Server

The `run_funnel_report` tool measures drop-off rates across your checkout steps so a marketing agent can identify friction points. A separate copywriting agent then reviews these drop-offs to suggest targeted landing page changes. This pipeline runs entirely without human intervention using CrewAI's sequential execution model. By exposing only this tool via `tool_filter`, you keep your agents focused on funnel optimization without distracting them with raw database exports.

Live traffic alerts with CrewAI

The `run_realtime_report` tool pulls active user counts and geographic locations to feed your monitoring crew. An alert agent processes these metrics to detect sudden traffic spikes or unexpected drops in real-time. This monitoring setup runs continuously in the background using hierarchical execution. The manager agent coordinates the reporting schedule, ensuring your team gets slack alerts the moment traffic anomalies occur.

Setup guide

Set up Google Analytics MCP in CrewAI

Prerequisites

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

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke Google Analytics tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="Google Analytics Analyst",
    goal="Access and analyze Google Analytics data via MCP.",
    backstory="Expert analyst with direct Google Analytics access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent Google Analytics transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="Google Analytics Analyst",
        goal="Access and analyze Google Analytics data via MCP.",
        backstory="Expert analyst with direct Google Analytics access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Google Analytics transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 Google Analytics 4. 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 Google 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 Google Analytics MCP in CrewAI

Install `crewai[tools]` and add the server's HTTP endpoint to the `mcps` list of your Agent configuration. This instantly exposes all 12 GA4 tools to that specific agent.

Yes, use the `MCPServerHTTP` class from `crewai.mcp` and define a `tool_filter`. This lets you restrict a copywriter agent to `get_metadata` while giving your analyst agent full access to `run_report`.

Your planning agent can run `check_compatibility` before executing a report query. This prevents the crew from getting stuck in loops trying to run invalid dimension and metric pairings.

Yes, an operator agent can trigger jobs with `list_audience_exports` and monitor them using `get_audience_export`. Once complete, the agent can hand the user list over to an email marketing agent.

Absolutely, because all data processed by the `get_user_activity` tool remains within your local runtime environment. The Vinkius MCP server uses ephemeral execution, meaning no personal user identifiers are saved or stored.

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