GA4 SEO MCP
Set up and audit GA4, Search Console and PageSpeed, read-only until you enable writes
- 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-mcpAdd 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.RequiredGA4SEO_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.

