Skip to content
MCP server

GA4 SEO MCP

Set up and audit GA4, Search Console and PageSpeed, read-only until you enable writes

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.2
Listing updated
today

Similar MCP servers

About GA4 SEO MCP

GA4 SEO MCP is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

Where many Google analytics servers only read reports, this one can also prepare a new site for measurement: the GA4 property and web stream, key events, custom dimensions, Search Console domain verification through a DNS TXT record, a sitemap submission and a PageSpeed baseline. A single bootstrap tool produces a plan by default and applies it only if the server was started with writes enabled, and it skips anything that already exists so it can be re-run.

Tools are grouped into toolsets (admin, data, gsc, psi, plus optional dataforseo and ads) so you enable only what you need and request only the matching OAuth scopes. The README counts 24 tools with the defaults and 37 with writes on. A doctor command checks credentials and scopes, and guided prompts cover a GA4 audit, a 360 SEO audit and a launch flow. Optional keyword research uses DataForSEO or the Google Ads Keyword Planner.

It installs with uvx and authenticates through Application Default Credentials or a service account. The author also offers paid done-for-you setup.

Install

Run in a terminal

claude mcp add ga4-seo-mcp --env PAGESPEED_API_KEY='<PAGESPEED_API_KEY>' --env DATAFORSEO_PASSWORD='<DATAFORSEO_PASSWORD>' --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' -- uvx ga4-seo-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ga4-seo-mcp": {
      "command": "uvx",
      "args": [
        "ga4-seo-mcp"
      ],
      "env": {
        "PAGESPEED_API_KEY": "<PAGESPEED_API_KEY>",
        "DATAFORSEO_PASSWORD": "<DATAFORSEO_PASSWORD>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ga4-seo-mcp": {
      "command": "uvx",
      "args": [
        "ga4-seo-mcp"
      ],
      "env": {
        "PAGESPEED_API_KEY": "<PAGESPEED_API_KEY>",
        "DATAFORSEO_PASSWORD": "<DATAFORSEO_PASSWORD>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "ga4-seo-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ga4-seo-mcp"
      ],
      "env": {
        "PAGESPEED_API_KEY": "<PAGESPEED_API_KEY>",
        "DATAFORSEO_PASSWORD": "<DATAFORSEO_PASSWORD>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ga4-seo-mcp": {
      "command": "uvx",
      "args": [
        "ga4-seo-mcp"
      ],
      "env": {
        "PAGESPEED_API_KEY": "<PAGESPEED_API_KEY>",
        "DATAFORSEO_PASSWORD": "<DATAFORSEO_PASSWORD>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ga4-seo-mcp": {
      "command": "uvx",
      "args": [
        "ga4-seo-mcp"
      ],
      "env": {
        "PAGESPEED_API_KEY": "<PAGESPEED_API_KEY>",
        "DATAFORSEO_PASSWORD": "<DATAFORSEO_PASSWORD>",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GOOGLE_APPLICATION_CREDENTIALSPath to a service account key file. Leave unset to use Application Default Credentials from gcloud.
  • GA4SEO_TOOLSETSComma-separated toolsets: admin,data,gsc,psi,dataforseo,ads.
  • GA4SEO_ENABLE_WRITESSet to 1 to register tools that create, update, delete, submit or verify. Off by default.
  • PAGESPEED_API_KEYPageSpeed Insights API key. Recommended: the anonymous quota is shared and often exhausted.
  • DATAFORSEO_LOGINDataForSEO login, for the dataforseo toolset.
  • DATAFORSEO_PASSWORDDataForSEO password, for the dataforseo toolset.
  • GOOGLE_ADS_DEVELOPER_TOKENGoogle Ads developer token, for the ads toolset.
  • GOOGLE_ADS_LOGIN_CUSTOMER_IDManager (MCC) customer ID, only when operating through a manager account.
  • GOOGLE_APPLICATION_CREDENTIALSPath of the mounted credentials file inside the container.Required
  • GA4SEO_TOOLSETSComma-separated toolsets: admin,data,gsc,psi,dataforseo,ads.
  • GA4SEO_ENABLE_WRITESSet to 1 to register tools that create, update, delete, submit or verify. Off by default.
  • PAGESPEED_API_KEYPageSpeed Insights API key. Recommended: the anonymous quota is shared and often exhausted.
  • DATAFORSEO_LOGINDataForSEO login, for the dataforseo toolset.
  • DATAFORSEO_PASSWORDDataForSEO password, for the dataforseo toolset.
  • GOOGLE_ADS_DEVELOPER_TOKENGoogle Ads developer token, for the ads toolset.
  • GOOGLE_ADS_LOGIN_CUSTOMER_IDManager (MCC) customer ID, only when operating through a manager account.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

bootstrap_site_measurement
Plan or apply GA4, Search Console and PageSpeed setup for a site
psi_audit
PageSpeed Insights audit
sc_verify_site_dns
Verify a Search Console domain via DNS
sc_submit_sitemap
Submit a sitemap to Search Console

What it does

Guarded writes
Write tools are not even registered unless enabled.
Site bootstrap
Plans or applies property, stream, key events and dimensions.
Search Console
Queries, pages, sitemaps and DNS verification.
PageSpeed audits
Lighthouse lab and CrUX field data.
Toolsets and scopes
Enable only needed toolsets to limit OAuth scopes.
Doctor command
Checks credentials, scopes and API access.
Keyword research
Optional DataForSEO and Google Ads Keyword Planner.

Good for

  • Launching a new site with analytics ready
  • Auditing an existing GA4 setup
  • Pulling last week's sessions and top pages
  • Recording a PageSpeed baseline

Pricing

Open source

Open source; optional DataForSEO toolset is paid by the provider

GA4 SEO MCP FAQ

Is it read-only?

Yes by default. Set GA4SEO_ENABLE_WRITES=1 or --enable-writes to register write tools.

How do I authenticate?

Application Default Credentials via gcloud with your own OAuth client, or a service account.

Does it cost anything?

The server is open source; DataForSEO is a paid service for its own toolset.

How do I install it?

claude mcp add ga4-seo -- uvx ga4-seo-mcp.

Is GA4 SEO MCP free?

Yes. GA4 SEO MCP is open source, so you can use and self-host it for free.

How do I add GA4 SEO MCP to Claude Code?

Run this command in your terminal: claude mcp add ga4-seo-mcp --env PAGESPEED_API_KEY='<PAGESPEED_API_KEY>' --env DATAFORSEO_PASSWORD='<DATAFORSEO_PASSWORD>' --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' -- uvx ga4-seo-mcp

What are the best alternatives to GA4 SEO MCP?

The closest alternatives to GA4 SEO MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Tapetide - Indian Stock Market MCP and World Monitor.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers