Google Search Console MCP Server

A Model Context Protocol (MCP) server providing access to Google Search Console & Google analytics

Documentation

Google Search Console MCP Server — The Complete Guide (2026)

Summarize with AI: ChatGPT · Perplexity · Claude · Grok

Quick answer: A Google Search Console MCP server is a Model Context Protocol connector that exposes live GSC data (and optionally GA4) as tools your AI assistant can call. Ask Claude, Cursor, or Codex questions like "What queries dropped this week?" and get real Search Console answers — no CSV exports, no tab switching.

Fastest path (recommended): GenieSeo — hosted, free during beta, 60-second setup, GSC + GA4, no credit card.

Full control: self-host with uvx mcp-search-console (see self-hosted setup).

GenieSeo beta — free right now: All 28 tools (21 Search Console + 7 GA4), one personal MCP URL, works in Claude on the web, Cursor, Codex, and Antigravity. Start free →

Watch setup video - connect Google Search Console and GA4 to Claude in 60 seconds

▶ Watch the 60-second setup video — sign up, connect Google, paste MCP URL into Claude

Last updated: June 11, 2026 · Reading time: ~18 minutes · Skill level: Beginner-friendly

This guide covers everything you need to connect Google Search Console (and optionally GA4) to Claude, Cursor, or Codex using the Model Context Protocol (MCP) — including a free hosted option, self-hosted install, 28 tool references, copy-paste prompts, and a video walkthrough.


Table of contents

  1. Video walkthrough — 60-second setup
  2. What is a Google Search Console MCP server?
  3. What does it cost? (free options)
  4. Why SEOs and developers use MCP for Search Console
  5. Google Analytics 4 on the same MCP URL
  6. All 28 MCP tools (reference)
  7. Hosted vs self-hosted: which should you choose?
  8. 60-second setup — GenieSeo (hosted)
  9. Self-hosted setup — open source
  10. Connect to Claude, Cursor, Codex & Antigravity
  11. Sample prompts and SEO workflows
  12. Use cases by role
  13. Security, privacy, and permissions
  14. Pricing
  15. Comparisons
  16. Architecture
  17. FAQ
  18. Resources and links

Video walkthrough — 60-second setup

Prefer to watch instead of read? Click the poster below to watch the GenieSeo setup video — sign up, connect Google OAuth, copy your MCP URL, paste into Claude. Free during beta, no credit card.

Covers: Google sign-in → MCP URL generation → Claude Settings → Connectors → your first Search Console query.

Self-hosted users: The setup video shows the hosted flow end-to-end. For uvx or clone installs, jump to self-hosted setup — credential setup takes 15–45 minutes.


What is a Google Search Console MCP server?

You open Google Search Console, add a filter, change the date range, export a CSV, build a pivot — and thirty minutes later you have answered one question that should have taken ten seconds.

What if you could just ask?

"Which pages lost traffic this month?" · "What keywords am I close to ranking on page one?" · "Are any URLs cannibalising each other?"

Model Context Protocol (MCP) is an open standard that lets AI clients connect to external data and tools over a single URL or local process — think of it as USB for AI. A Google Search Console MCP server implements that protocol for GSC: it translates natural-language requests from your AI into Google Search Console API calls and returns structured JSON your model can reason over.

You set it up once. After that, you ask questions in plain English and get answers from your real Search Console data — not generic training-data guesses.

flowchart LR
  A[You in Claude / Cursor / Codex] --> B[MCP client]
  B --> C[Google Search Console MCP Server]
  C --> D[Google Search Console API]
  C --> E[Google Analytics 4 API]
  D --> F[Queries, clicks, indexing, sitemaps]
  E --> G[Sessions, conversions, funnels]
  F --> C
  G --> C
  C --> B
  B --> A

What you get:

Without MCPWith a GSC MCP server
Export CSV from GSC, paste into chatAsk "Top 20 queries last 28 days with CTR under 2%"
Manual URL Inspection one URL at a timeBatch-inspect 10 URLs in one tool call
Switch between GSC and GA4 tabsCross-reference clicks (GSC) with conversions (GA4) in one conversation
Static screenshots for stakeholdersAI generates tables, summaries, and recommendations from live data

What you can do

Connect GenieSeo to Claude, Cursor, or Codex and work from live Search Console and GA4 data — track rankings, fix indexing, spot content opportunities, cross-reference traffic with conversions, and run SEO workflows in plain English.

This is not a chatbot product. GenieSeo and self-hosted GSC MCP servers are connectors. The conversation stays inside Claude, Cursor, Codex, or Antigravity — your AI gains superpowers, not a new UI to learn.


What does it cost? (free options)

Everything you need to get started is free.

ItemCost
Google Search Console APIFree
Google Analytics 4 APIFree
GenieSeo (hosted MCP, beta)Free — no credit card
Self-hosted (uvx mcp-search-console)Free (MIT license)
Claude / Cursor (many plans)Free tier works for testing

The only real “cost” is setup time: ~60 seconds on GenieSeo, or 15–45 minutes if you self-host with Google Cloud OAuth.


Why SEOs and developers use MCP for Search Console

Problems MCP solves

  1. Context switching — GSC UI is built for humans clicking filters, not for agents running repeatable audits across dozens of properties.
  2. Export friction — Search Analytics caps exports; URL Inspection is one URL per click.
  3. Analysis gap — Raw data in a spreadsheet still needs an analyst. MCP puts the analyst (your LLM) on the same pipe as the data.
  4. Cross-channel blind spots — Search Console shows who clicked; GA4 shows what happened next. A combined MCP URL closes that loop.

Who benefits

RoleTypical workflow
SEO specialistWeekly rank reviews, cannibalization checks, content opportunity mining
Agency account managerMulti-client audits, client-ready summaries, indexing triage
DeveloperIndexing errors, canonical issues, and fixes — in the same IDE as the code
Content marketerQuery-to-page mapping, CTR optimization, briefs from real search demand
Startup founderOrganic growth snapshots without hiring an SEO tool stack

GenieSeo - free beta: Google Search Console + GA4 MCP for Claude, Cursor, and Codex

GenieSeo is free during beta — 28 tools, one MCP URL, no Python required. Start free →


Google Analytics 4 on the same MCP URL

Most open-source GSC MCP servers are Search Console only. The stack documented here adds 7 GA4 tools on the same MCP endpoint and same Google OAuth consent (webmasters.readonly + analytics.readonly).

Why pair GSC + GA4?

Data sourceAnswers
Google Search ConsoleWhich queries and pages earn impressions and clicks; indexing status; sitemap health
Google Analytics 4Sessions, engaged users, conversions, revenue, realtime traffic, funnels

Example cross-reference prompt:

"For my top 10 organic landing pages by clicks (last 28 days), pull GA4 engaged sessions and conversion rate. Flag pages with high clicks but conversion rate below site average."

That single question uses GSC search analytics and GA4 run_ga4_report — impossible in one step without a combined connector.

Disable GA4 (self-hosted only): set GSC_DISABLE_GA4=true to expose GSC tools only.


All 28 MCP tools (reference)

Call get_capabilities first in any session — it returns auth status and the full tool list.

Authentication (1 tool)

ToolDescription
reauthenticateRe-run OAuth browser login; use when tokens expire or you need to switch Google accounts

Google Search Console — Properties (3 tools)

ToolParametersDescription
list_propertiesList all GSC properties (start here for site_url)
get_site_detailssite_urlVerification and ownership details
get_creator_infoServer metadata and attribution

Google Search Console — Analytics & reporting (5 tools)

ToolExample questionDescription
get_search_analytics"Top 20 queries last 28 days with CTR under 2%"Top queries/pages with clicks, impressions, CTR, position
get_performance_overview"How is my site doing this month?"High-level KPI snapshot
compare_search_periods"Which queries improved vs last month?"Period-over-period deltas
get_search_by_page_query"What keywords drive traffic to /pricing?"Queries driving traffic to one page
get_advanced_search_analytics"Top US mobile queries in the last 90 days"Multi-dimension analytics (country, device, query, page)

Google Search Console — URL inspection & indexing (3 tools)

ToolExample questionDescription
inspect_url_enhanced"Is this URL indexed and what is the canonical?"Full crawl/index/canonical/mobile/structured-data status
batch_url_inspection"Inspect my top 10 pages by clicks"Bulk inspection in one call (up to 10 URLs)
check_indexing_issues"Which of these URLs have indexing problems?"Prioritized indexing problem summary

Google Search Console — Sitemaps (5 tools)

ToolKey parametersDescription
get_sitemapssite_urlList sitemaps
list_sitemaps_enhancedsite_urlDetailed sitemap status, errors, warnings
get_sitemap_detailssite_url, sitemap_urlSingle sitemap deep dive
submit_sitemapsite_url, sitemap_urlSubmit a sitemap
manage_sitemapssite_url, actionSubmit or delete sitemaps

Google Search Console — Destructive (disabled by default, 2 tools)

Requires GSC_ALLOW_DESTRUCTIVE=true:

ToolDescription
add_siteAdd a property to GSC
delete_siteRemove a property from GSC

Google Analytics 4 (7 tools)

ToolKey parametersDescription
list_ga4_propertiesAll GA4 properties on the connected account (start here)
get_ga4_property_detailsproperty_idTime zone, currency, industry, parent account
get_ga4_custom_dimensions_and_metricsproperty_idCustom definitions on the property
list_ga4_ads_linksproperty_idLinked Google Ads accounts
list_ga4_property_annotationsproperty_idDate markers for data-affecting events
run_ga4_reportproperty_id, dimensions, metrics, datesFlexible reporting (sessions, users, revenue, etc.)
run_ga4_realtime_reportproperty_idLast ~30 minutes of live activity
run_ga4_funnel_reportproperty_id, funnel stepsStep-by-step conversion funnel

Meta (1 tool)

ToolDescription
get_capabilitiesFull tool catalog + live auth status — call this first

Hosted vs self-hosted: which should you choose?

FactorGenieSeo (hosted, free beta)Self-hosted (uvx mcp-search-console)
Setup time~60 seconds15–45 minutes (Google Cloud + client config)
Python / terminalNot requiredRequired (uvx or clone)
GA4 toolsIncluded (7 tools)Included in this stack
Claude on the web (claude.ai)Yes — HTTPS MCP URLNo by default (stdio = Desktop only)
Claude DesktopYesYes
CursorYesYes (with local config)
OAuthOne-click Google sign-inManual client_secrets.json
Token storageManaged securely by GenieSeoLocal token.json on your machine
CostFree during beta (no credit card)Free (MIT license)
Best forSEOs, agencies, fast onboardingDevelopers, air-gapped, custom deployments

Recommendation:

  • Choose GenieSeo if you want to query in under a minute, need GA4 + GSC together, use Claude on the web, or share access with non-technical teammates — currently free in beta.
  • Choose self-hosted if you need full control over credentials, custom Docker deployments, or zero dependency on a hosted service.

60-second setup — GenieSeo (hosted)

GenieSeo is the hosted Google Search Console MCP server with GA4 — one personal MCP URL, Streamable HTTP transport, no client_secrets.json. Free during beta (no credit card).

Watch first (recommended)

Click the image to follow along — under two minutes from sign-up to your first Claude query.

Steps

  1. Sign up at seo.geniedial.in/signupfree beta, no credit card
  2. Connect Google — single OAuth screen for Search Console + Analytics read access
  3. Copy your MCP URL from the GenieSeo dashboard (format: https://seo.geniedial.in/mcp/u/YOUR_TOKEN)
  4. Paste into your AI client (see client guides below)
  5. Ask your first question: "List my Search Console properties" or "Call get_capabilities"

MCP config snippet (any Streamable HTTP client)

{
  "mcpServers": {
    "genieseo": {
      "url": "https://seo.geniedial.in/mcp/u/YOUR_TOKEN"
    }
  }
}

Replace YOUR_TOKEN with the token from your GenieSeo dashboard.

Transport: Streamable HTTP (MCP spec 2025-03-26) — single /mcp endpoint for POST (JSON-RPC), GET (streaming), DELETE (session end).


Self-hosted setup — open source

The open-source Google Search Console MCP server runs locally via uvx or from a cloned repo. GA4 tools load automatically unless GSC_DISABLE_GA4=true.

Prerequisites

  • Python 3.11+
  • uv (recommended) or virtualenv
  • Google Cloud project with Search Console API enabled
  • For GA4: Google Analytics Data API and Google Analytics Admin API enabled on the same project

Option A — OAuth (recommended for individuals)

  1. Google Cloud Console → Create/select project
  2. Enable Search Console API
  3. Enable Analytics Data API and Analytics Admin API (for GA4 tools)
  4. Credentials → Create → OAuth client ID → Desktop app
  5. Download JSON → save as e.g. ~/Documents/client_secrets.json
  6. On first run, browser opens for Google login; token saved to platform config dir

Option B — Service account (automation / teams)

  1. Create service account + download JSON key
  2. Add service account email to each GSC property (Settings → Users → Full access)
  3. For GA4: grant Viewer (or higher) in GA4 Admin for each property
  4. Set GSC_CREDENTIALS_PATH and GSC_SKIP_OAUTH=true

Install with uvx (fastest self-hosted)

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env

# Verify
uv --version
which uvx

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

Use the full path from which uvx — GUI apps do not read your shell PATH.

Service account variant:

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/full/path/to/service_account.json",
        "GSC_SKIP_OAUTH": "true"
      }
    }
  }
}

Clone and run locally

Prefer uvx mcp-search-console when you only need to run the server — no clone required (see Option A above).

To modify source code locally:

git clone https://github.com/AminForou/mcp-gsc.git
cd mcp-gsc
uv venv .venv
uv pip install -r requirements.txt
uv run python gsc_server.py

Environment variables

VariableDefaultDescription
GSC_OAUTH_CLIENT_SECRETS_FILEPath to OAuth client secrets JSON
GSC_CREDENTIALS_PATHPath to service account JSON
GSC_SKIP_OAUTHfalseForce service account mode
GSC_DATA_STATEallall = GSC dashboard parity; final = confirmed data only (2–3 day lag)
GSC_ALLOW_DESTRUCTIVEfalseEnable add_site, delete_site, sitemap delete
GSC_DISABLE_GA4falseSkip GA4 tool registration
MCP_TRANSPORTstdioSet streamable-http for remote/Docker
MCP_HOST127.0.0.1Bind host for HTTP transport
MCP_PORT3001Bind port for HTTP transport

Docker (remote / container)

docker build -t mcp-gsc .
docker run \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_PORT=3001 \
  -e GSC_CREDENTIALS_PATH=/app/credentials.json \
  -v /path/to/credentials.json:/app/credentials.json \
  -p 3001:3001 \
  mcp-gsc

Endpoint: http://<host>:3001/mcp

Note: Deprecated sse transport is removed. Use streamable-http only.

Cursor Marketplace skills (self-hosted in Cursor)

Search mcp-search-console in the Cursor Marketplace for bundled skills:

SkillInvoke withPurpose
seo-weekly-report"Run the SEO weekly report for example.com"28-day performance + period comparison
cannibalization-check"Check keyword cannibalization on example.com"Competing pages per query
indexing-audit"Audit indexing for my top pages"Batch inspect top URLs
content-opportunities"Find content opportunities for example.com"Position 11–20 + high impressions

Verify installation

Ask your AI: "List my GSC properties" or "Call get_capabilities".


Connect to Claude, Cursor, Codex & Antigravity

Claude (web — claude.ai)

Requires Streamable HTTP URL (GenieSeo hosted). Local stdio servers do not work in the browser.

  1. Claude → SettingsConnectorsAdd custom MCP
  2. Name: GenieSeo
  3. URL: https://seo.geniedial.in/mcp/u/YOUR_TOKEN
  4. Save → start a new chat → ask about Search Console data

Full guide: Connect Search Console to Claude

Claude Desktop

  • Hosted: same URL as above in MCP settings
  • Self-hosted: claude_desktop_config.json with uvx + env vars (see self-hosted)

Cursor

  1. SettingsMCPAdd MCP server
  2. Name: GenieSeo
  3. URL: your GenieSeo MCP URL (or local streamable-http endpoint)
  4. Use in Chat or Composer (Agent mode) — agents call MCP tools directly

Full guide: Connect Search Console to Cursor

Codex CLI

~/.codex/config.toml:

[mcp_servers.genieseo]
url = "https://seo.geniedial.in/mcp/u/YOUR_TOKEN"
enabled = true

Self-hosted OAuth:

[mcp_servers.gscServer]
command = "/FULL/PATH/TO/uvx"
args = ["mcp-search-console"]
enabled = true
env = { GSC_OAUTH_CLIENT_SECRETS_FILE = "/full/path/to/client_secrets.json" }

Antigravity

Add the same GenieSeo MCP URL in Antigravity MCP settings. One URL works across all Streamable HTTP clients.


Sample prompts and SEO workflows

Search performance

Show me the top 20 search queries for [site] in the last 30 days.
Highlight any with CTR below 2% and suggest title tag improvements.
Compare my site's Search Console performance between last month and the month before.
Which queries improved position the most? Which pages lost clicks?
Find queries with high impressions but average position below 10,
filtered to mobile traffic in the United States only.

Indexing and technical SEO

Check these URLs for indexing issues:
https://example.com/product
https://example.com/services
https://example.com/about

Group results by issue type and prioritize fixes by estimated traffic impact.
Inspect my top 20 pages by clicks (last 28 days) for indexing status.
Return a table: URL, index status, canonical, last crawl, recommended action.

Sitemaps

List all sitemaps for [site], flag any with errors or warnings,
and recommend which sitemap entries to investigate first.

GA4 analytics

List my GA4 properties, then for property [ID] run a report:
sessions and conversions by landing page for the last 28 days, organic traffic only.
Show realtime active users on [property] broken down by country.

GSC + GA4 cross-reference

Pull my top 15 organic landing pages by GSC clicks (last 28 days).
For each, get GA4 engaged sessions and conversion rate.
Flag high-click / low-conversion pages and suggest hypotheses.

Agency weekly review

For client site [site_url]:
1. Top 50 queries this week vs last week
2. Flag positions that dropped more than 3 places
3. List affected URLs
4. Draft a 3-bullet client email summary

Use cases by role

SEO agency

  • Weekly rank reviews across many client properties without CSV exports
  • Technical audits — batch URL inspection + GA4 traffic triage
  • Client reports — structured markdown or JSON your AI formats for decks

Guide: AI-powered SEO workflows for agencies

Freelance SEO

  • Cannibalization detection, content gap analysis, indexing triage on a laptop between calls

Developer

  • Diagnose indexing, canonical, and structured-data issues inside Cursor while editing the fix

Guide: Developers + Search Console in Cursor

Content marketer

  • Query-to-page mapping, CTR optimization from real Search Console demand data

Startup

  • Organic growth snapshots and content prioritization without a full SEO tool subscription

Security, privacy, and permissions

OAuth scopes (read-only by default)

ScopeAccess
webmasters.readonlySearch Console data (analytics, inspection, sitemaps)
analytics.readonlyGA4 reports and property metadata

Write operations (submit sitemap, add/delete site) require explicit server configuration (GSC_ALLOW_DESTRUCTIVE=true) on self-hosted deployments.

GenieSeo hosted

  • OAuth tokens encrypted at rest
  • Per-user MCP URL — tokens not shared between accounts
  • Revoke access anytime via Google Account permissions or the GenieSeo dashboard
  • No selling of Google data; connector-only architecture

Self-hosted

  • Tokens stored locally (token.json in platform user config directory)
  • You control network exposure (default: stdio, no open ports)
  • Docker/HTTP deployments: secure credentials volume and TLS termination at your edge

Pricing

PlanPriceIncludes
GenieSeo BetaFree (no credit card)28 tools, GSC + GA4, hosted MCP URL, all verified properties on connected Google account — free during beta
GenieSeo Pro (roadmap)TBDTeam workspaces, higher limits, priority support
Self-hostedFree (MIT)Full codebase, unlimited properties, your infrastructure costs only

Details: seo.geniedial.in/pricing

Claude and Cursor are billed separately by Anthropic and Cursor. GenieSeo is only the data connector — free during beta.


Comparisons

GenieSeo vs self-hosted GSC-only MCP servers

GenieSeo (hosted, free beta)Typical self-hosted GSC MCP
GA4Yes (7 tools)Usually no
Claude webYesNo (stdio default)
Setup~60s~30 min
PackageHosted URLuvx mcp-search-console or local clone

Full comparison: GenieSeo vs other GSC MCP servers

GenieSeo vs Advanced GSC Visualizer (Chrome extension)

GenieSeo MCPAdvanced GSC Visualizer
Where it runsClaude, Cursor, CodexInside GSC browser tab
AI workflowsYesNo
GA4YesNo

Full comparison: GenieSeo vs Advanced GSC

Best Google Search Console MCP servers (2026 roundup)

See the curated comparison: Best GSC MCP servers 2026


Architecture

Single-file MCP server (self-hosted core)

The server is built with FastMCP — no custom framework. Core modules:

FileRole
gsc_server.pyGSC tools, OAuth/service-account auth, MCP transport
ga4_tools.pyGA4 tools registered on the same FastMCP instance

Auth order:

  1. OAuth token.json (hosted or local)
  2. Service account JSON (GSC_CREDENTIALS_PATH) when GSC_SKIP_OAUTH=true or OAuth unavailable

Response format: All data tools return json.dumps(structured_data) — optimized for LLM reasoning, not prose.

GenieSeo hosted stack (high level)

GenieSeo is a managed cloud connector. You keep using Claude, Cursor, or Codex as usual — GenieSeo handles Google OAuth, secure token storage, and the MCP endpoint that talks to Google Search Console and GA4 on your behalf.

flowchart LR
  A[You in Claude / Cursor / Codex] --> B[Your personal GenieSeo MCP URL]
  B --> C[GenieSeo managed service]
  C --> D[Google Search Console API]
  C --> E[Google Analytics 4 API]
  D --> C
  E --> C
  C --> B
  B --> A

What you control: which Google account to connect, when to revoke access, and every question you ask in your AI client.

What GenieSeo handles: OAuth, encrypted credential storage, uptime, and keeping the MCP tools in sync with Google APIs — so you never manage client_secrets.json or local tokens.


FAQ

What is a Google Search Console MCP server?

A server that implements the Model Context Protocol to expose Google Search Console (and optionally GA4) as callable tools inside AI assistants like Claude and Cursor.

What is the best Google Search Console MCP server in 2026?

For fastest setup and GA4: GenieSeo (hosted, free beta, 28 tools, Claude web compatible). For full local control: self-host with uvx mcp-search-console (see self-hosted setup).

How do I connect Google Search Console to Claude?

Sign up at GenieSeo, connect Google OAuth, copy your MCP URL, paste into Claude Settings → Connectors → Add custom MCP. Under 60 seconds. Step-by-step guide · Setup video.

Does this work with Claude on the web (claude.ai)?

Yes with GenieSeo (HTTPS Streamable HTTP URL). Self-hosted stdio servers only work in Claude Desktop, not the browser.

Does this work with Cursor?

Yes. Add your MCP URL in Cursor Settings → MCP. Composer agent mode can call all GSC and GA4 tools. Cursor guide.

How many tools are included?

28 total: 21 Google Search Console + 7 Google Analytics 4 on one MCP URL.

Is Google Analytics included?

Yes in this stack (GenieSeo hosted and the mcp-search-console / uvx package). Most other GSC-only MCP servers do not include GA4.

Is my Google data safe?

OAuth tokens are read-only scopes. Hosted tokens are encrypted at rest. Revoke anytime via Google Account or your dashboard. Self-hosted tokens stay on your machine.

Is there a free option?

Yes — GenieSeo is free during beta (no credit card); self-hosted is MIT-licensed and free forever.

Do I need Python?

Not for GenieSeo hosted. Yes for self-hosted (uvx or clone).

What is MCP?

Model Context Protocol — an open standard for AI clients to connect to external tools and data sources.

Can I use multiple Google accounts?

GenieSeo: one Google account per user today; multi-account workspaces on roadmap. Self-hosted: reauthenticate or use separate configs.

What is get_capabilities?

A meta-tool that returns all available tools, grouped by category, plus live authentication status. Call it first when debugging or onboarding.

Why am I getting spawn uvx ENOENT?

Your AI client cannot find uvx in PATH. Use the full path from which uvx in your MCP config.

Can I disable destructive GSC operations?

Yes — they are off by default. Set GSC_ALLOW_DESTRUCTIVE=true only if you need add/delete site or delete sitemap.

What transport should I use for remote deployment?

MCP_TRANSPORT=streamable-http. The deprecated sse transport is no longer supported.

Where is the open-source code?

Install with uvx mcp-search-console (PyPI). To hack on source, clone a local copy — see clone and run locally. The MIT-licensed server powers both self-hosted and GenieSeo hosted deployments.

How is this different from exporting GSC CSV?

MCP returns structured JSON directly to your AI — no manual export, no row limits in chat, and the model can chain multiple tool calls (inspect → analyze → recommend) in one conversation.

Can agencies use this for clients?

Yes. Connect a Google account with access to client properties; each team member can have their own MCP URL. Switch properties mid-conversation by naming the site_url.


Resources and links

Product

ResourceURL
GenieSeo — Get started (free beta)https://seo.geniedial.in/signup
GenieSeo homepagehttps://seo.geniedial.in
Pricinghttps://seo.geniedial.in/pricing
Recipe library (copy-paste prompts)https://seo.geniedial.in/recipes
Setup videoWatch setup video

Self-hosted (open source)

ResourceURL
PyPI package (recommended)uvx mcp-search-console
LicenseMIT
Clone for developmentSee clone and run locally

Setup guides

ClientURL
Claudehttps://seo.geniedial.in/integrations/claude
Cursorhttps://seo.geniedial.in/integrations/cursor
Codexhttps://seo.geniedial.in/integrations/codex
ChatGPThttps://seo.geniedial.in/integrations/chatgpt
All integrationshttps://seo.geniedial.in/integrations

Blog and SEO content

TopicURL
GSC MCP overviewhttps://seo.geniedial.in/blog/google-search-console-mcp-server
Connect GSC to Claudehttps://seo.geniedial.in/blog/connect-google-search-console-to-claude-ai
GA4 MCP serverhttps://seo.geniedial.in/blog/ga4-mcp-server-claude-cursor
Best GSC MCP servers 2026https://seo.geniedial.in/blog/best-google-search-console-mcp-servers-2026

Support


Changelog (server)

VersionHighlights
NextStreamable HTTP transport; sse removed
0.3.2OAuth fix for uvx; get_capabilities tool; better auth errors
0.3.0Cursor Marketplace plugin; 4 SEO skills; structured JSON output
0.2.xSafety mode for destructive ops; Docker; HTTP transport
0.1.0Initial 19 GSC tools; OAuth + service account

Built by Peakenza Software Services. GenieSeo is free during beta. Self-hosted stack is MIT-licensed. Questions: support@geniedial.in