# Searchconsole Mcp

> MCP server for Google Search Console — query keywords, pages, sitemaps, and more from AI assistants

- **Type:** MCP server
- **Install:** `agentstack add mcp-chrishart0-searchconsole-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [chrishart0](https://agentstack.voostack.com/s/chrishart0)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [chrishart0](https://github.com/chrishart0)
- **Source:** https://github.com/chrishart0/searchconsole-mcp

## Install

```sh
agentstack add mcp-chrishart0-searchconsole-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# searchconsole-mcp

[](https://github.com/chrishart0/searchconsole-mcp/actions/workflows/ci.yml)
[](https://www.python.org/downloads/)
[](LICENSE)

An [MCP](https://modelcontextprotocol.io/) server that gives AI assistants read-only access to your Google Search Console data. Ask questions about your site's search performance in natural language — keywords, clicks, impressions, CTR, rankings, sitemaps, and more.

## Tools

| Tool | Description |
|------|-------------|
| `list_sites` | Lists all verified Search Console properties with permission levels |
| `query_search_analytics` | Query keyword/page data — clicks, impressions, CTR, average position. Supports filtering by dimension, date range, search type, and pagination |
| `list_sitemaps` | Lists submitted sitemaps for a property |

## Quick Start

### 1. Install

```bash
git clone https://github.com/chrishart0/searchconsole-mcp.git
cd searchconsole-mcp
uv sync
```

### 2. Authenticate

This server uses [Google Application Default Credentials](https://cloud.google.com/docs/authentication/application-default-credentials). Choose one:

**Option A — Service account key** (recommended for automation):
```bash
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json
```

**Option B — User credentials** (recommended for local development):
```bash
gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/webmasters.readonly"
```

The service account or user must have access to the Search Console properties you want to query.

### 3. Connect to your MCP client

Claude Code

Add to `~/.claude.json`:

```json
{
  "mcpServers": {
    "searchconsole-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/searchconsole-mcp", "searchconsole-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/key.json"
      }
    }
  }
}
```

Claude Desktop

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

```json
{
  "mcpServers": {
    "searchconsole-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/searchconsole-mcp", "searchconsole-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/key.json"
      }
    }
  }
}
```

Other MCP clients

Any MCP-compatible client can connect over stdio. Run the server with:

```bash
uv run --directory /path/to/searchconsole-mcp searchconsole-mcp
```

## Example Prompts

Once connected, try asking your AI assistant:

- "What are my top 10 keywords by clicks this month?"
- "Show me pages with high impressions but low CTR"
- "List all my Search Console properties"
- "What queries is my site ranking for on page 2 of Google?"
- "Show me my sitemaps and their status"

## Development

```bash
uv sync --dev
uv run pytest
```

## License

[MIT](LICENSE)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [chrishart0](https://github.com/chrishart0)
- **Source:** [chrishart0/searchconsole-mcp](https://github.com/chrishart0/searchconsole-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-chrishart0-searchconsole-mcp
- Seller: https://agentstack.voostack.com/s/chrishart0
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.