Commands Reference - Search Console MCP

The CLI provides two categories of commands: Interactive Admin Commands (for configuration and authentication) and the Tool Runner (to run SEO intelligence tools).

Interactive Admin Commands

These commands manage authentication, configuration, and diagnostics.

`setup`

Starts the interactive configuration wizard to connect your Google Search Console, Bing Webmaster Tools, or Google Analytics 4 accounts.

What it does: Opens a browser window for secure OAuth authorization and saves credentials.
Usage:
npx search-console-mcp setup

Triggers the OAuth login flow specifically to authorize a new account.

Usage:
npx search-console-mcp login

`logout`

Revokes active OAuth tokens and logs out from all connected Google accounts.

Usage:
npx search-console-mcp logout

`accounts`

Manages connected search engine accounts.

Subcommands:
- list: Display all authorized Google, Bing, and GA4 accounts along with their associated sites.
- add-site: Authorize a specific site or domain for an account.
- remove: Remove a connected account.

Usage:

npx search-console-mcp accounts list
npx search-console-mcp accounts remove --account=user@company.com

`sites`

A quick shortcut to display all verified sites across all connected accounts.

Usage:
npx search-console-mcp sites

`diagnostics`

Runs diagnostic checks to troubleshoot connection errors, quota limits, and API authorization status.

Usage:
npx search-console-mcp diagnostics

`update`

Triggers an automated check and updates the search-console-mcp package to the latest version.

Usage:
npx search-console-mcp update

Tool Runner Command (`run`)

The run subcommand lets you execute any registered MCP tool.

Syntax

npx search-console-mcp run <tool_name> [options] [--format=json|csv|table]

Passing Arguments

CLI arguments correspond directly to the properties defined in each tool’s Zod schema. You can pass them in two ways:

Equals sign: --siteUrl=https://example.com
Space separated: --siteUrl https://example.com

Boolean flags can be toggled on by passing --flag or turned off using --no-flag (e.g. --no-enabled).

Formatting Results

Renders tool outputs in your preferred layout:

# Print as CSV
npx search-console-mcp run sites_list --engine=google --format=csv

# Print as a clean ASCII table
npx search-console-mcp run seo_striking_distance --siteUrl=https://example.com --format=table

Finding Tool Names & Options

You can list all available tools or inspect options for a single tool by appending --help:

# List all executable tools
npx search-console-mcp run --help

# Show arguments for a specific tool
npx search-console-mcp run analytics_query --help

To see the detailed schemas and metrics returned by each tool, refer to the Tools section in the MCP Server tab.

​Interactive Admin Commands

​setup

​login

​logout

​accounts

​sites

​diagnostics

​update

​Tool Runner Command (run)

​Syntax

​Passing Arguments

​Formatting Results

​Finding Tool Names & Options