Search Console MCP Server

Access Google Search Console, Bing Webmaster Tools, and Google Analytics 4.

README.md

Search Console MCP

A Model Context Protocol (MCP) server that transforms how you interact with Google Search Console, Bing Webmaster Tools, and Google Analytics 4. Stop exporting CSVs and start asking questions.

📚 View Documentation


Why use this?

❌ The Old, Broken Way

  • Data Silos: Manually checking Google, then Bing, then GA4.
  • Manual Correlation: Exporting 3 different CSVs and using VLOOKUPs to see if your #1 ranking page actually converts.
  • Switching Fatigue: Logging in and out to manage multiple clients or properties.
  • AI Context Limits: Uploading giant spreadsheets that hit context limits and cause model hallucinations.

✅ The Search Console MCP Way

  • Platform Synergy: GSC + Bing + GA4 in a single context window. Stop exporting, start analyzing.
  • Deterministic Intelligence: The server performs the complex SEO math (cannibalization, Z-score anomalies, striking distance) so your AI agent gets curated insights, not raw data piles.
  • Cross-Platform ROI: Use the Opportunity Matrix to prioritize keywords that have high search visibility (GSC) but poor on-site engagement (GA4).
  • Zero-Config Multi-Account: Connect 20+ accounts. The server automatically resolves the correct credentials for every site URL.

One Server. Three Platforms. Infinite Accounts. Actionable Intelligence.


🎯 Magic Prompts

Copy and paste these into your MCP client (Claude Desktop, etc.) to see the intelligence engine in action:

🔍 The Traffic Detective

"My traffic dropped this week compared to last. Use the anomaly detection and time-series tools to find exactly when the drop started and which pages are responsible."

🎯 The "Striking Distance" Hunter

"Find keywords for https://example.com where I'm ranking in positions 8-15 but have at least 1,000 impressions. These are my best opportunities for a quick traffic boost."

⚔️ The Cannibalization Cleaner

"Check for keyword cannibalization. Are there any queries where two or more of my pages are competing and splitting the traffic? Suggest which one should be the primary authority."

📈 The SEO Opportunity Scoreboard

"Analyze my top 50 keywords for the last 90 days. Rank them by a custom 'Opportunity Score' (Impressions / Position). Give me the top 5 specific pages to focus on."

📊 The Executive Health Check

"Run a full SEO health check for my site. Segment the results by Brand vs. Non-Brand and give me 3 high-impact actions for the upcoming week."

⚡ The Speed vs. Ranking Correlator

"Fetch the top 5 pages by impressions. For these pages, run a PageSpeed audit. Is there any correlation between low performance scores and recently declining positions?"

🔀 Multi-Engine Comparison

"Compare my performance between Google and Bing for the last 30 days. Which keywords are ranking better on Bing but have lower traffic on Google?"

🎯 Bing Opportunity Finder

"Show me keywords where I'm in the top 5 on Google but not ranking on Bing. These are my easy Bing wins."

⚠️ Google Dependency Check

"Am I too dependent on Google? Check my click share across both engines and flag any keywords where over 85% of traffic comes from Google."

💰 The ROI Prioritizer (GSC + GA4)

"Run an opportunity_matrix for my top 20 pages. Which high-visibility pages have the lowest engagement or conversion rates? These are my conversion optimization priorities."


🔐 Authentication (Desktop Flow)

Search Console MCP uses a Secure Desktop Flow. This provides high-security, professional grade authentication for your Google account:

  • Multi-Account Support: Connect multiple Google and Bing accounts. The server automatically picks the right one for each site.
  • System Keychain Primary: Tokens are stored in your OS's native credential manager (macOS Keychain, Windows Credential Manager, or Linux Secret Service).
  • AES-256-GCM Hardware-Bound Encryption: Fallback storage is encrypted with AES-256-GCM using a key derived from your unique hardware machine ID. Tokens stolen from your machine cannot be decrypted on another computer.
  • Silent Background Refresh: Tokens auto-refresh silently when they expire.

🚀 Step 1 — Initiate Login

Run the following command to start the authorization process:

npx search-console-mcp setup

The CLI will:

  1. Briefly start a secure local server to handle the redirect.
  2. Open your default web browser to the Google Authorization page.
  3. Automatically fetch your email after authorization to label your credentials securely.

🔑 Step 2 — Logout & Management

To w

Tools 3

opportunity_matrixAnalyzes top pages to identify high-visibility keywords with low engagement or conversion rates.
run_seo_health_checkPerforms a comprehensive SEO audit segmenting results by brand and non-brand traffic.
check_cannibalizationIdentifies queries where multiple pages are competing for the same traffic.

Try it

My traffic dropped this week compared to last. Use the anomaly detection and time-series tools to find exactly when the drop started and which pages are responsible.
Find keywords for https://example.com where I'm ranking in positions 8-15 but have at least 1,000 impressions.
Check for keyword cannibalization. Are there any queries where two or more of my pages are competing and splitting the traffic?
Run an opportunity_matrix for my top 20 pages. Which high-visibility pages have the lowest engagement or conversion rates?
Compare my performance between Google and Bing for the last 30 days. Which keywords are ranking better on Bing but have lower traffic on Google?

Frequently Asked Questions

What are the key features of Search Console MCP?

Unified access to Google Search Console, Bing Webmaster Tools, and Google Analytics 4. Automated SEO math including cannibalization detection and Z-score anomaly analysis. Cross-platform ROI analysis via the Opportunity Matrix. Secure desktop authentication flow with native OS keychain storage. Zero-config multi-account support for 20+ properties.

What can I use Search Console MCP for?

Identifying 'striking distance' keywords to boost traffic for pages ranking in positions 8-15. Resolving keyword cannibalization issues where multiple pages compete for the same query. Prioritizing conversion optimization by correlating GSC visibility with GA4 engagement data. Performing cross-engine SEO audits to compare performance between Google and Bing. Automating weekly SEO health checks to segment brand vs. non-brand performance.

How do I install Search Console MCP?

Install Search Console MCP by running: npx search-console-mcp setup

What MCP clients work with Search Console MCP?

Search Console MCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Search Console MCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Open Conare