# Search Console MCP

> Search Console MCP is an open-source MCP server for marketing and seo. Read-only Google Search Console MCP server with one browser sign-in and no Cloud project. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://www.getpercy.io/search-console-mcp
- **Repository:** https://github.com/sudomichael/search-console-mcp
- **MCP Registry name:** io.github.sudomichael/search-console-mcp
- **Categories:** marketing and SEO, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/search-console-mcp-2
