Skip to content
MCP server

Search Console MCP

Read-only Google Search Console MCP server with one browser sign-in and no Cloud project

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.2.3
Listing updated
3 days ago

About Search Console MCP

Search Console MCP is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

Setup is npx search-console-mcp-server login: your browser opens, you sign in with Google, and tokens are stored in ~/.search-console-mcp/ on your machine. There is no Google Cloud project, API key or service-account JSON, and the scope is read-only by construction. The README says nothing passes through anyone's servers.

The six tools cover your properties, search analytics by query, page, date, country or device including Google Discover, period-over-period comparison with deltas computed, single and batch URL inspection of up to 10 URLs, and sitemaps. Ten built-in prompts work as slash commands, among them seo_checkup, traffic_drop, traffic_decay, striking_distance, cannibalization_check and indexing_audit.

Limits come from Google's API: data lags 2 to 3 days, about 16 months of history, 1,000 rows per query and hidden rare queries. It is MIT licensed and published by the makers of Percy, a separate paid SEO service.

Install

Run in a terminal

claude mcp add search-console-mcp -- npx -y search-console-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "search-console-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "search-console-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "search-console-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "search-console-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "search-console-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "search-console-mcp-server"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "search-console-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "search-console-mcp-server"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "search-console-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "search-console-mcp-server"
      ]
    }
  }
}

What it does

One-step sign-in
Browser Google login, no Cloud project or keys.
Read-only scope
Changing your properties is impossible.
Search analytics
Clicks, impressions, CTR and position by many dimensions, including Discover.
Period comparison
Deltas computed and sorted by biggest change.
URL inspection
Check one URL or up to 10 at once.
Built-in analyses
Ten prompts such as traffic_drop and striking_distance.

Good for

  • Find pages that lost the most clicks this month
  • List queries stuck just below page one
  • Check whether a page is indexed and why not
  • Audit sitemaps and index status after a launch

Pricing

Open source

Free, MIT licensed

Prices change. Check getpercy.io before you buy.

Search Console MCP FAQ

Do I need a Google Cloud project?

No. One browser sign-in is enough, though you can supply your own client ID and secret.

Can it change my Search Console data?

No. The scope is read-only.

Where are tokens stored?

Only in ~/.search-console-mcp/ on your machine.

How fresh is the data?

It lags 2 to 3 days, so ask about ranges ending three days ago.

Is Search Console MCP free?

Yes. Search Console MCP is open source, so you can use and self-host it for free.

How do I add Search Console MCP to Claude Code?

Run this command in your terminal: claude mcp add search-console-mcp -- npx -y search-console-mcp-server

What are the best alternatives to Search Console MCP?

The closest alternatives to Search Console MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

Alternatives to Search Console MCP

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data