How to integrate Google Analytics MCP with Atomic Agent

Connect Atomic Agent to Google Analytics MCP. Show all google analytics accounts i manage, get detailed info for a specific account, and more using natural language, with authentication handled for you.

Google Analytics logoGoogle Analytics
Oauth2

Google Analytics tracks and reports website traffic, user behavior, and conversions. It helps marketers optimize performance and understand customer journeys.

67 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Google Analytics.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Google Analytics account. See the Atomic Agent documentation for installation instructions.

Also integrate Google Analytics with

How Atomic Agent connects to Google Analytics

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Google Analytics to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Google Analytics. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Google Analytics account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Google Analytics MCP server, and what's possible with it?

The Google Analytics MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Google Analytics account. It provides structured and secure access to your analytics data, enabling your agent to analyze traffic, retrieve account info, list audiences, and build custom datasets on your behalf.

  • View and manage analytics accounts: Let your agent retrieve detailed information about specific Google Analytics accounts or list all accounts you have access to.
  • Audience insights and segmentation: Easily have your agent list all audiences associated with a GA4 property, helping you understand and segment your visitors.
  • Create custom expanded datasets: Direct your agent to combine key dimensions and metrics into tailored datasets for deeper analysis and reporting.
  • Efficient property and resource discovery: Have your agent confirm the existence of properties and fetch their details, streamlining your analytics management workflow.

Use Google Analytics from Atomic Agent

With your account connected, ask Atomic Agent to work with Google Analytics in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Google Analytics action and event your agent gets out of the box.

Archive Custom Dimension

Tool to archive a CustomDimension on a property.

Batch Run Pivot Reports

Tool to return multiple pivot reports in a batch for a GA4 property.

Batch Run Reports

Tool to return multiple analytics data reports in a batch.

Check Compatibility

Tool to list dimensions and metrics compatible with a GA4 report request.

Create Audience Export

Tool to create an audience export for Google Analytics.

Create Audience List

Tool to create an audience list for later retrieval by initiating a long-running asynchronous request.

Create Custom Dimension

Tool to create a CustomDimension for a Google Analytics property.

Create Custom Metric

Tool to create a custom metric in Google Analytics.

Create Expanded Data Set

Tool to create an expanded data set for a property.

Create Recurring Audience List

Tool to create a recurring audience list that automatically generates new audience lists daily based on the latest data.

Create Report Task

Tool to create a report task as a long-running asynchronous request for customized Google Analytics event data reports.

Create Rollup Property

Tool to create a roll-up property.

Get Account

Tool to retrieve a single Account by its resource name.

Get Attribution Settings

Tool to retrieve attribution configuration for a Google Analytics property.

Get Audience

Tool to retrieve a single Audience configuration from a Google Analytics property.

Get Audience Export

Tool to get configuration metadata about a specific audience export.

Get Audience List

Tool to get configuration metadata about a specific audience list.

Get Custom Dimension

Tool to retrieve a single CustomDimension by its resource name.

Get Data Retention Settings

Tool to retrieve data retention configuration for a Google Analytics property.

Get Data Sharing Settings

Tool to retrieve data sharing configuration for a Google Analytics account.

Get Google Signals Settings

Tool to retrieve Google Signals configuration settings for a GA4 property.

Get Key Event

Tool to retrieve a Key Event.

Get Metadata

Tool to get metadata for dimensions, metrics, and comparisons for a GA4 property.

Get Property

Tool to retrieve a single GA4 Property by its resource name.

Get Property Quotas Snapshot

Tool to retrieve all property quotas organized by category (corePropertyQuota, funnelPropertyQuota, realtimePropertyQuota) for a given GA4 property.

Get Recurring Audience List

Tool to get configuration metadata about a specific recurring audience list.

Get Report Task

Tool to get report metadata about a specific report task.

List Account Summaries

Tool to retrieve summaries of all Google Analytics accounts accessible by the caller.

List Accounts (v1beta)

Tool to list all Google Analytics accounts accessible by the caller using v1beta API.

List AdSense Links

Tool to list all AdSenseLinks on a property.

List Audience Exports

Tool to list all audience exports for a property.

List Audience Lists

Tool to list all audience lists for a specified property to help find and reuse existing lists.

List Audiences

Tool to list Audiences on a property.

List BigQuery Links

Tool to list BigQuery Links on a property.

List Calculated Metrics

List Calculated Metrics

List Channel Groups

Tool to list ChannelGroups on a property.

List Conversion Events

Tool to list conversion events on a property.

List Custom Dimensions

List Custom Dimensions

List Custom Metrics

Tool to list CustomMetrics on a property.

List DataStreams

Tool to list DataStreams on a property.

List Display & Video 360 Advertiser Links

Tool to list Display & Video 360 advertiser links on a property.

List DisplayVideo360 Advertiser Link Proposals

Tool to list DisplayVideo360AdvertiserLinkProposals on a property.

List Event Create Rules

Tool to list EventCreateRules configured on a web data stream.

List Expanded Data Sets

Tool to list ExpandedDataSets on a property.

List Firebase Links

Tool to list FirebaseLinks on a property.

List Google Ads Links

Tool to list GoogleAdsLinks on a property.

List Key Events

Tool to list Key Events.

List Measurement Protocol Secrets

Tool to list MeasurementProtocolSecrets under a data stream.

List Property

Tool to list GA4 properties based on filter criteria.

List Recurring Audience Lists

Tool to list all recurring audience lists for a GA4 property.

List Reporting Data Annotations

Tool to list all Reporting Data Annotations for a specific property.

List Report Tasks

Tool to list all report tasks for a Google Analytics property.

List Search Ads 360 Links

Tool to list all SearchAds360Links on a property.

List SKAdNetwork Conversion Value Schemas

Tool to list SKAdNetworkConversionValueSchema configurations for an iOS data stream.

List Subproperty Event Filters

Tool to list all subproperty event filters on a property.

List Subproperty Sync Configs

Tool to list SubpropertySyncConfig resources for managing subproperty synchronization configurations.

Provision Account Ticket

Tool to request a ticket for creating a Google Analytics account.

Query Audience Export

Tool to query a completed audience export.

Query Audience List

Tool to query an audience list.

Query Report Task

Tool to retrieve a report task's content.

Run Funnel Report

Tool to run a GA4 funnel report.

Run Pivot Report

Tool to run a customized pivot report of Google Analytics event data.

Run Realtime Report

Tool to run a customized realtime report of Google Analytics event data.

Run Report

Tool to run a customized GA4 data report.

Send Events

Tool to send event data to Google Analytics 4 using the Measurement Protocol.

Update Property

Tool to update an existing GA4 Property.

Validate Events

Tool to validate Measurement Protocol events before sending them to production.

FAQ

Frequently asked questions

With a standalone Google Analytics MCP server, the agents and LLMs can only access a fixed set of Google Analytics tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Google Analytics and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Google Analytics tools.

Yes, absolutely. You can configure which Google Analytics scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Google Analytics data and credentials are handled as safely as possible.

Start with Google Analytics.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Google Analytics tool your agent needs.Free to start.

Start building