Google Docs Universal MCP Server

Google Docs Universal MCP Server

What is Google Docs Universal MCP Server about?

Google Docs Universal MCP Server implements a Universal MCP‑compliant service that exposes Google Docs functionality through a unified, programmatic interface. It allows developers to call Google Docs tools as part of larger workflows without dealing with Google’s native APIs directly.

How to use Google Docs Universal MCP Server?

1. Prerequisites: Install Python 3.11+ and the uv package manager (pip install uv).
2. Setup:

   uv sync                     # install dependencies into .venv
   source .venv/bin/activate   # activate virtual environment (Windows: .venv\Scripts\Activate)
   

3. Run the MCP inspector:

   mcp dev src/universal_mcp_google_docs/server.py
   

   Note the address and port displayed.
4. Install the application (makes the service available to other MCP clients):

   mcp install src/universal_mcp_google_docs/server.py
   

5. Access the service through any MCP‑compatible client or via the web UI at agentr.dev/apps after enabling the Google Docs app.

Key Features of Google Docs Universal MCP Server

• Universal MCP compliance – interoperable with any MCP‑compatible toolchain.
• Python‑first implementation – leverages modern Python (3.11+) and uv for fast dependency management.
• Ready‑to‑run server – single entry point (server.py) launches an inspector for debugging and testing.
• Comprehensive toolset – all available Google Docs operations are listed in src/universal_mcp_google_docs/README.md.
• Simple local development workflow – clear instructions for environment setup and activation.

Use Cases of Google Docs Universal MCP Server

• Automated document generation within AI agents that need to create or edit Google Docs.
• Integration of Google Docs into custom workflow automation platforms (e.g., funneling data from CRM into a shared doc).
• Testing and prototyping of Google Docs interactions without using the official API keys directly.
• Embedding Google Docs capabilities into multi‑agent systems that coordinate via MCP.

FAQ from the Google Docs Universal MCP Server

Q: Do I need a Google API key? A: The server expects required credentials to be provided via environment variables (e.g., GOOGLE_APPLICATION_CREDENTIALS). Set them in the .env file before running.

Q: Can I run this on Windows? A: Yes. Activate the virtual environment with \.venv\Scripts\Activate and use the same mcp commands.

Q: Is there a Docker image available? A: The repository does not include a Dockerfile, but you can containerize the service by installing the project’s dependencies and executing mcp dev … inside the container.

Q: How do I add custom tools? A: Extend src/universal_mcp_google_docs/app.py with new functions and update the README in that folder; the server will expose them automatically.

Q: Where can I see the list of supported Google Docs operations? A: Refer to src/universal_mcp_google_docs/README.md for the full catalog of tools.

Google-Docs Universal MCP Server

This repository contains an implementation of an Google-Docs Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Google-Docs'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-Docs directly from agentr.dev. Visit agentr.dev/apps and enable Google-Docs.

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_docs/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_docs/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_docs/server.py
   

📁 Project Structure

.
├── src/
│   └── universal_mcp_google_docs/
│       ├── __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! 🚀