Skip to main content
We designed search-console-mcp to work instantly with your favorite AI editor. No complex configuration required.

​
Prerequisites

  1. Node.js 18 or higher
  2. A verified Google Search Console property

​
🚀 One-Line Setup

Run this command in your terminal. It will authenticate you with Google and generate the configuration you need. 
npx search-console-mcp setup
The tool will open your browser for secure authentication and then display the exact code snippet to copy-paste into your config.

​
Client Configuration

If you prefer to set it up manually, here are the instructions for the most popular clients.

​
Claude Desktop

Add this to your claude_desktop_config.json: 
{
  "mcpServers": {
    "search-console": {
      "command": "npx",
      "args": ["-y", "search-console-mcp"]
    }
  }
}
That’s it! No environment variables needed if you ran the setup command.

​
Cursor

  1. Open Cursor Settings (Cmd + ,).
  2. Navigate to Features > MCP.
  3. Click + Add New MCP Server.
  4. Enter the following:
    • Name: Search Console
    • Type: command
    • Command: npx -y search-console-mcp
If you see an error about “command not found,” try using the full path to your node executable or npm prefix.

​
VS Code

You can configure the server specifically for your workspace using the standard MCP extension.
  1. Option A: Config File Create a file named .vscode/mcp.json and add: 
    {
    "servers": {
        "search-console": {
            "command": "npx",
            "args": [
                "-y",
                "search-console-mcp"
            ]
        }
    }
}
  2. Option B: Command Palette
    • Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P).
    • Search for “MCP: Add Server”.
    • Enter the command: npx -y search-console-mcp.