Kodros Search Console MCP
Provides read-only access to Google Cloud Resource Manager v3 for searching and retrieving Cloud projects.
Provides tools to read Google Search Console data and manage site properties and sitemaps. Supports listing properties, search analytics by query, page, country, device, or date, sitemap status, URL inspection, adding or removing properties, and submitting or removing sitemaps with explicit confirmation for writes.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
kodros-search-console-mcp
An MCP server that lets an AI assistant read Google Search Console data and manage site properties and sitemaps. Every write needs the assistant to repeat the exact site URL or sitemap path back, so a vague request cannot delete the wrong thing.
Part of the Kodros tooling for running product websites.
How it works
flowchart LR
subgraph Setup[One-time sign-in]
A[authorize.py] -->|loopback listener, random port, state check| G[Google OAuth]
G -->|ID token: verified email, optional expected account| T[(token.json, mode 0600)]
end
C[MCP client] -->|stdio| S[server.py: 11 tools]
S --> T
S -->|reads| SC[Search Console API]
S -->|writes need confirm_site_url or confirm_feedpath| SC
S -->|read-only| RM[Cloud Resource Manager v3]Reads: list properties, search analytics by query, page, country, device or date, sitemap status, and URL inspection. Writes: add or remove a property, submit or remove a sitemap. Cloud project search and get are read-only. The sign-in script ignores any callback that lacks the OAuth state value and saves credentials only for a verified email.
Related MCP server: search-console-mcp
Stack
Python 3.11, FastMCP 3, google-api-python-client, google-auth-oauthlib, uv.
Run
You need a Google Cloud project with the Search Console API and Cloud Resource Manager API enabled, and a Desktop OAuth client JSON.
uv sync
uv run python authorize.py --client-secret /path/to/client_secret.json --expected-email you@example.com
uv run python server.pyRegister it as a stdio server: command uv, args --directory /path/to/kodros-search-console-mcp run python server.py.
Settings: GOOGLE_API_MCP_TOKEN_FILE, GOOGLE_API_MCP_CLIENT_FILE and GOOGLE_API_MCP_ACCOUNT. Defaults live under ~/.config/google-api-mcp/. set-client-secret.py updates the client JSON after you rotate the secret.
Status and limits
Version 0.1.0. No test suite yet. A smoke check confirmed the 11 tools register and the email check passes, matches and rejects against a stubbed Google flow. Live API calls were not run against a real account in this repo.
Scopes:
webmasters,cloud-platform.read-only,openid,userinfo.email.Removing a property removes it from your Search Console account, not from your website.
It calls Google with your credentials. Review each write before an assistant runs it.
License
Copyright 2026 Tanner Osterkamp. All rights reserved. See LICENSE. The source is public to read; ask before reuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Google Search Console for AI assistants: traffic, rankings, indexing and page checks. Read-only.
Read-only Google Search Console and Google Analytics for AI agents.
SEO rankings and traffic from Google Search Console for AI assistants, read-only
Read-only Google Search Console MCP server for AI assistants.
Related MCP Servers
- AlicenseAqualityDmaintenanceConnects Google Search Console to AI assistants, enabling natural language analysis of SEO data. Provides read-only tools for properties, search analytics, URL inspection, and sitemaps.15MIT
- 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
- AlicenseAqualityDmaintenanceEnables AI assistants to analyze Google Search Console SEO data through natural language, including search analytics, URL inspection, sitemap management, and property management.21MIT
- AlicenseNot gradedqualityCmaintenanceLets AI assistants analyze search performance, inspect URLs and indexing issues, and manage sitemaps through read/write actions, with destructive operations disabled by default.MIT