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

$3

``bash
npx gsc-mcp-server --setup
`

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

$3

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:

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

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

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

$3

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