google-seo-mcp
Provides tools for managing Search Console properties, sitemaps, search analytics (clicks, impressions, CTR, position), and URL inspection including index status, mobile usability, and rich results.
Enables running PageSpeed Insights analysis to obtain Core Web Vitals metrics and Lighthouse performance reports for any URL, without requiring OAuth.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@google-seo-mcp Inspect URL https://example.com/page"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
๐ google-seo-mcp
Full Google SEO & analytics stack for AI agents โ over one MCP server.
Search Console ยท Indexing API ยท GA4 (Admin + Data) ยท Tag Manager ยท PageSpeed Insights
A Model Context Protocol server that gives Claude (and any MCP client) hands-on control of the Google SEO and analytics stack โ list and claim properties, query search performance, submit URLs for indexing, spin up GA4 properties and data streams (i.e. install the measurement tag), wire up Tag Manager, and run PageSpeed audits. Ships with self-configuring OAuth2: no tokens at launch โ the agent walks through authorization with built-in tools.
โจ Highlights
๐ Search Console โ properties, sitemaps, search analytics, URL inspection
โก Indexing API โ push
URL_UPDATED/URL_DELETEDnotifications๐ GA4 โ create properties & web data streams (get the Measurement ID), run reports & realtime
๐ท๏ธ Tag Manager โ accounts, containers, workspaces, tags
๐ฆ PageSpeed Insights โ Core Web Vitals + Lighthouse, no OAuth needed
๐ Self-configuring OAuth2 โ loopback code capture + auto-refresh, stored locally
๐ก๏ธ Safety rails โ read-only mode and per-call confirm guards
Related MCP server: Google Search Console MCP Server
๐ฆ Installation
Run straight from npm with npx (no install needed), or build from source:
# from source
git clone https://github.com/skiddgoddamn/google-seo-mcp
cd google-seo-mcp
npm install && npm run build๐ Connect to your MCP client
Add to your MCP config (e.g. ~/.claude.json or claude_desktop_config.json):
{
"mcpServers": {
"google-seo": {
"command": "npx",
"args": ["-y", "google-seo-mcp"],
"env": { "GOOGLE_PSI_API_KEY": "" }
}
}
}{
"mcpServers": {
"google-seo": {
"command": "node",
"args": ["F:/projects/google-seo-mcp/build/index.js"]
}
}
}โ๏ธ Google Cloud setup
Create an OAuth 2.0 Client ID โ application type Desktop app
Enable these APIs for the project:
Google Search Console API ยท Indexing API ยท Analytics Admin API ยท Analytics Data API ยท Tag Manager API
On the OAuth consent screen, add your Google account as a test user (while the app is in "Testing")
Keep the Client ID and Client Secret handy
๐ Authorize (self-setup)
No tokens needed at startup โ run these tools from your agent, in order:
Step | Tool | What happens |
1 |
| Save your OAuth Client ID + Client Secret |
2 |
| Opens Google's consent screen and captures the code via a local loopback server |
โณ |
| Headless fallback โ paste the code + redirect URI manually |
โ |
| Check what's configured and whether the token is valid |
The refresh token is saved to ~/.google-seo-mcp/config.json and reused (and auto-refreshed) on every run.
โ๏ธ Environment variables
Variable | Default | Description |
|
| Block every mutating tool ( |
|
| Require a |
|
|
|
|
| Log request/response bodies to stderr (verbose) |
| โ | Append log lines to a file (default: stderr only) |
|
| Override the config directory |
| โ | PageSpeed Insights key; anonymous (rate-limited) if unset |
See .env.example for a ready-to-copy template.
๐งฐ Tool reference
๐ Auth โ g_
Tool | Description |
| Show OAuth configuration status and token validity |
| Save OAuth |
| Open the consent screen via loopback and store the refresh token |
| Manually exchange an authorization code for a refresh token |
๐ Search Console โ gsc_
Tool | Description |
| List all Search Console properties |
| Get a single property and your permission level |
| Add (claim) a property |
| Remove a property |
| List submitted sitemaps |
| Get a sitemap's status |
| Submit a sitemap |
| Delete a sitemap |
| Clicks / impressions / CTR / position by query, page, country, device, date |
| Index status, coverage, mobile usability, rich results |
โก Indexing API โ idx_
Tool | Description |
| Notify Google a URL was added/updated ( |
| Notify Google a URL was removed ( |
| Latest indexing-notification metadata for a URL |
โน๏ธ The Indexing API is officially eligible only for pages with
JobPostingorBroadcastEventstructured data. Other URLs may be ignored.
๐ GA4 โ ga4_
Tool | Description |
| List Analytics accounts |
| List properties under an account |
| Get a property |
| Create a GA4 property |
| List a property's data streams |
| Create a web data stream โ returns the Measurement ID |
| Get a data stream |
| Run a report (metrics + dimensions over a date range) |
| Run a realtime report |
๐ท๏ธ Tag Manager โ gtm_
Tool | Description |
| List GTM accounts |
| List containers under an account |
| Create a container โ returns its GTM-ID |
| List workspaces of a container |
| List tags in a workspace |
| Create a tag in a workspace |
๐ฆ PageSpeed Insights โ psi_
Tool | Description |
| Analyze a URL โ Core Web Vitals + Lighthouse (no OAuth required) |
๐ก๏ธ Safety rails
G_READONLY=trueโ blocks every tool whose name contains_add_create_update_delete_submit_set. Reads still work.G_CONFIRM=trueโ mutating tools return a preview and require a follow-up call withconfirm: true.
๐ License
MIT ยฉ skiddgoddamn
Available Tools
17 toolsga4_datastream_createA
GA4 Admin: create a WEB data stream (returns the Measurement ID / tag โ i.e. installs the GA4 counter).
Inputs: default_uri (required), property_id (required), display_name (required).
ga4_datastreams_getB
GA4 Admin: list data streams of a property.
Inputs: property_id (required).
ga4_property_createB
GA4 Admin: create a new GA4 property under an account.
Inputs: time_zone (required), account_id (required), display_name (required), currency_code.
gsc_site_addC
Search Console: add (claim) a property.
Inputs: site_url (required).
gsc_site_deleteB
Search Console: remove a property from the account.
Inputs: site_url (required).
gsc_site_getA
Search Console: get one property and the user's permission level.
Inputs: site_url (required).
gsc_sitemaps_getB
Search Console: list submitted sitemaps for a property.
Inputs: site_url (required).
gsc_sites_getA
Search Console: list all properties for the user.
Inputs: no named parameters.
g_set_codeA
Manual fallback: paste an authorization code obtained by opening the authorize_url with a known redirect_uri (for headless machines).
Inputs: code (required), redirect_uri (required).
g_set_credentialsB
Save the Google OAuth app client_id and client_secret. Create a 'Desktop app' OAuth client at https://console.cloud.google.com/apis/credentials and enable the Search Console, Indexing, Analytics Admin/Data, Tag Manager APIs.
Inputs: client_id (required), client_secret (required).
gtm_accounts_getB
Tag Manager: list GTM accounts.
Inputs: no named parameters.
gtm_container_createC
Tag Manager: create a container (returns its GTM-ID).
Inputs: name (required), account_id (required), usage_context.
gtm_containers_getC
Tag Manager: list containers under an account.
Inputs: account_id (required).
gtm_tag_createC
Tag Manager: create a tag in a workspace. Pass the raw GTM tag object (type + parameters).
Inputs: tag (required), account_id (required), container_id (required), workspace_id (required).
gtm_tags_getC
Tag Manager: list tags in a workspace.
Inputs: account_id (required), container_id (required), workspace_id (required).
gtm_workspaces_getC
Tag Manager: list workspaces of a container.
Inputs: account_id (required), container_id (required).
psi_runA
PageSpeed Insights: analyze a URL (Core Web Vitals + Lighthouse). No OAuth needed; uses GOOGLE_PSI_API_KEY if set.
Inputs: url (required), locale, category, strategy.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 17 tools
Each tool targets a distinct service and action. For example, gtm_tag_create is clearly different from gsc_sites_get, and the descriptions remove any ambiguity. There is no overlap in functionality.
Most tools follow a 'service_operation' pattern (e.g., gtm_tag_create, ga4_property_create), but 'g_set_credentials' and 'g_set_code' deviate with a 'g_' prefix. 'psi_run' also breaks the pattern. This inconsistency could confuse an agent.
With 17 tools across multiple Google services (Search Console, GA4, Tag Manager, PageSpeed), the count is appropriate. Each tool serves a clear purpose, and the number is neither too small nor too large for the scope.
The tools cover basic CRUD for Search Console and GA4 setup, but lack update/delete for tags, sitemap submission, and Analytics Data API reporting. Some lifecycle operations are missing, which may require workarounds.
Maintenance
Related MCP Connectors
SEO & marketing toolkit for AI agents: GA4, Search Console, AdSense, GTM, PageSpeed, Trends.
Read-only Google Search Console and Google Analytics for AI agents.
Marketing data and actions for AI agents: GA4, Search Console, ads, social, SEO and WordPress.
Google Search Console for AI assistants: traffic, rankings, indexing and page checks. Read-only.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to manage Google Tag Manager, Google Search Console, and Google Analytics (GA4) through unified access to tags, search performance data, URL inspection, sitemaps, and analytics reporting.7 npmISC
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to query Google Search Console data including search analytics, URL inspection, sitemap management, and site performance monitoring, with per-user OAuth authentication.-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to access Google Search Console search performance and index health data, including clicks, impressions, rankings, URL inspection, and sitemap management.32 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents to query and analyze Google Search Console data, including search analytics, URL inspection, sitemaps, and property verification, and to perform actions like submitting sitemaps and adding properties through natural language.1924 npm1MIT