Google Search Console MCP Server

Connect Claude to your Google Search Console data. Query search analytics, check indexing status, and manage sitemaps through natural conversation.

Prerequisites

• Node.js 18+ installed
• Google Search Console account with at least one verified property
• Claude Desktop app installed

Installation

1. Run Setup

npx gsc-mcp-server --setup

This will open a browser for you to sign in with your Google account. That's it!

2. Add to Claude Desktop

Open your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the server configuration:

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

If you already have other MCP servers, add it with a comma:

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

3. Restart Claude Desktop

Quit and reopen Claude Desktop to load the new server.

Usage

Once configured, ask Claude things like:

| What you want | Example prompt | |---------------|----------------| | Top search queries | "What are my top 10 search queries this month?" | | Page performance | "How is my /blog page performing in search?" | | Check indexing | "Is https://mysite.com/new-post indexed?" | | Compare periods | "Compare my search traffic this week vs last week" | | Find opportunities | "Show me queries with high impressions but low CTR" | | Manage sitemaps | "List my sitemaps" or "Submit my new sitemap" |

Available Tools

| Tool | Description | |------|-------------| | gsc_list_sites | List all your Search Console properties | | gsc_search_analytics | Query clicks, impressions, CTR, and position | | gsc_inspect_url | Check if a URL is indexed | | gsc_list_sitemaps | List submitted sitemaps | | gsc_get_sitemap | Get sitemap details | | gsc_submit_sitemap | Submit a new sitemap | | gsc_delete_sitemap | Remove a sitemap |

Troubleshooting

"Permission denied" for a site? → Make sure your Google account has access to that property in Search Console

Need to re-authenticate? → Run npx gsc-mcp-server --setup again

Session expired? → Run npx gsc-mcp-server --setup to sign in again

Privacy

All data stays on your machine. See our Privacy Policy.

License

MIT