Skip to main content
Glama
Kodros Search Console MCP

Kodros Search Console MCP

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

Register 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…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Connects 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.
      15
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to access Google Search Console search performance and index health data, including clicks, impressions, rankings, URL inspection, and sitemap management.
      32 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to analyze Google Search Console SEO data through natural language, including search analytics, URL inspection, sitemap management, and property management.
      21
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets AI assistants analyze search performance, inspect URLs and indexing issues, and manage sitemaps through read/write actions, with destructive operations disabled by default.
      MIT