Connect your MCP client

Install Google Search Console MCP once, then run one setup command for your client.

Choose your client

Run the command for the app you use. Setup signs in to Google, lets you select Search Console properties, then configures or prints the client steps. Quick Connect uses read-only access. Setup runs quietly by default; add --verbose or --dry-run for the full detail.

Set up Claude Desktop (app)

gsc setup --client desktop
  • Answer with target numbers (for example 1,3), all for every installer, or Enter for the default.
  • Follow setup's preview and approve the client configuration change.
  • Complete Google sign-in in your browser, then restart the client.
  • Setup preserves other MCP server entries when it updates a supported config file.
  • OpenCode and Pi are configured globally only: OpenCode merges into ~/.config/opencode/opencode.json under the mcp key, and Pi merges into ~/.omp/agent/mcp.json under mcpServers.

Other MCP clients

For an app without a built-in setup target, choose the JSON output destination during setup or print a generic configuration and add it through that app's MCP settings. The template uses absolute runtime and package paths.

Print a generic MCP configuration

gsc config print --client generic

Check the connection

Verify Google access

gsc doctor
gsc auth status --online

The client should show the Google Search Console MCP tools after you restart it. If it does not, see Troubleshooting.

More help