MCP Google Workspace Server

You can run an MCP server that lets AI agents perform Google Drive, Docs, and Sheets operations. It supports multiple transport modes and integrates with MCP-compatible clients, enabling seamless automation and collaboration workflows around Google Workspace.

How to use

Start the MCP server using your preferred transport method. The server exposes operations for Drive, Docs, and Sheets, and you can connect via standard MCP clients to issue actions like searching files, creating documents, or updating spreadsheet values. Use the provided environment variables to authenticate with Google Cloud APIs, and authenticate your session once per install.

How to install

Prerequisites: ensure you have Python and/or a compatible runtime available, and that you can install local packages.

Option 1: Install via uvx (recommended)

uvx mcp-google-suite

Option 2: Install via Python package manager (pip)

pip install mcp-google-suite

Development setup steps (for contributors)

# Clone the project
git clone git@github.com:adexltd/mcp-google-suite.git && cd mcp-google-suite

# Set up a virtual environment and install the package in editable mode
uv venv && source .venv/bin/activate  # on Windows use .venv\Scripts\activate
uv pip install -e .

Configuration

Configure your MCP client to connect to the Google Workspace MCP server. Two standard ways are shown here to accommodate your preferred installation method. Each setup includes the required Google credentials environment variables.

{
  "mcpServers": {
    "mcp-google-suite": {
      "command": "uvx",
      "args": ["mcp-google-suite"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json",
        "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json"
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-google-suite": {
      "command": "python",
      "args": ["-m", "mcp_google_suite"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json",
        "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json"
      }
    }
  }
}

Google OAuth setup

Prepare Google Cloud credentials and enable APIs so the MCP server can access Drive, Docs, and Sheets.

Steps you follow:

Authenticate with the server by running the authentication flow when prompted.

Available tools and operations

You can perform a range of Google Workspace operations through the MCP server. The following tools are available:

Available tools

drive_search_files

Search Google Drive files using a query and optional page size to control results.

drive_create_folder

Create a new folder in Google Drive with a specified name and optional parent folder.

docs_create

Create a new Google Doc with a given title and optional initial content.

docs_get_content

Retrieve the content of a Google Doc by its document ID.

docs_update_content

Update the content of a Google Doc by its document ID.

sheets_create

Create a new Google Sheet with a given title and optional sheet names.

sheets_get_values

Read cell values from a specified range in a Google Sheet.

sheets_update_values

Update cells in a Google Sheet within a specified range with provided values.