# GA4 SEO MCP

> GA4 SEO MCP is an open-source MCP server for marketing and seo. Set up and audit GA4, Search Console and PageSpeed, read-only until you enable writes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/germaniu/ga4-seo-mcp
- **MCP Registry name:** io.github.GermaniU/ga4-seo-mcp
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/ga4-seo-mcp
