Google SearchConsole Universal MCP Server

What is Google SearchConsole Universal MCP Server about?

It implements a Google Search Console MCP server that exposes Search Console data and actions through a consistent, protocol‑driven API, enabling seamless integration with other MCP‑compliant tools.

How to use Google SearchConsole Universal MCP Server?

1. Install the required dependencies with uv (uv sync).
2. Activate the virtual environment (source .venv/bin/activate on Unix, .venv\Scripts\Activate on Windows).
3. Start the MCP inspector: mcp dev src/universal_mcp_google_searchconsole/server.py to view the running address.
4. Register the server with the MCP ecosystem: mcp install src/universal_mcp_google_searchconsole/server.py.
5. Access the service through the MCP inspector UI or via any MCP client.

Key features of Google SearchConsole Universal MCP Server

• Full coverage of Google Search Console endpoints wrapped in MCP calls.
• Compatibility with all MCP‑compliant applications and tools.
• Easy local development with uv and built‑in MCP commands.
• Clear documentation of available tools in src/universal_mcp_google_searchconsole/README.md.
• MIT‑licensed for unrestricted use and modification.

Use cases of Google SearchConsole Universal MCP Server

• Integrate Search Console analytics into custom dashboards or reporting pipelines.
• Automate SEO monitoring and alerting by querying performance data via MCP.
• Combine Search Console metrics with other data sources in a unified MCP workflow.
• Enable third‑party agents (e.g., on agentr.dev) to interact with Search Console without dealing with OAuth token handling directly.

FAQ from the Google SearchConsole Universal MCP Server

Q: Which Python version is required? A: Python 3.11 or newer.

Q: Do I need to set any environment variables? A: The .env file can hold your Google API credentials (e.g., GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET).

Q: Can I deploy this server to a cloud platform? A: Yes—once the virtual environment is prepared, run the same mcp dev command on the target host.

Q: Is there a Docker image available? A: Not provided in the repository, but you can containerize the project using the standard Python base image.

Q: How do I contribute? A: Fork the repository, make changes, and submit a pull request. All contributions must comply with the MIT license.

Google SearchConsole Universal MCP Server

This repository contains an implementation of an Google SearchConsole Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Google SearchConsole's tools and services through a unified API.

The server is built using the Universal MCP framework.

This implementation follows the MCP specification, ensuring compatibility with other MCP-compliant services and tools.

Usage

You can start using Google SearchConsole directly from agentr.dev. Visit agentr.dev/apps and enable Google SearchConsole.

If you have not used universal mcp before follow the setup instructions at agentr.dev/quickstart

Available Tools

The full list of available tools is at ./src/universal_mcp_google_searchconsole/README.md

Local Development

📋 Prerequisites

Ensure you have the following before you begin:

• Python 3.11+ (recommended)
• uv (install globally with pip install uv)

🛠️ Setup Instructions

Follow the steps below to set up your development environment:

1. Sync Project Dependencies

   uv sync
   

   This installs all dependencies from pyproject.toml into a local virtual environment (.venv).

2. Activate the Virtual Environment

   For Linux/macOS:

   source .venv/bin/activate
   

   For Windows (PowerShell):

   .venv\Scripts\Activate
   

3. Start the MCP Inspector

   mcp dev src/universal_mcp_google_searchconsole/server.py
   

   This will start the MCP inspector. Make note of the address and port shown in the console output.

4. Install the Application

   mcp install src/universal_mcp_google_searchconsole/server.py
   

📁 Project Structure

.
├── src/
│   └── universal_mcp_google_searchconsole/
│       ├── __init__.py       # Package initializer
│       ├── server.py            # Server entry point
│       ├── app.py            # Application tools
│       └── README.md         # List of application tools
├── tests/                    # Test suite
├── .env                      # Environment variables for local development
├── pyproject.toml            # Project configuration
└── README.md                 # This file

📄 License

This project is licensed under the MIT License.

---

Generated with MCP CLI — Happy coding! 🚀