Google Workspace

by distrihub

1 stars
Not rated
GitHub

About

Integrates with Google Workspace to enable file management in Drive and data manipulation in Sheets, facilitating document-centric tasks and data analysis within the Google ecosystem.

Details

Author
distrihub
Repository
distrihub/mcp-google-workspace
GitHub stars
1
License
MIT License
Categories
Productivity, Developer Tools, Design, Workplace, File Management, AI, Project Management, Infrastructure
Tags
#integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Google Workspace
    Command (node, npx, python, etc.) mcp-google
    Arguments
    • Argument 1 drive
    • Argument 2 --access-token
    • Argument 3 $${ACCESS_TOKEN}
    Environment
    • ACCESS_TOKEN ACCESS_TOKEN
    • GOOGLE_CLIENT_ID GOOGLE_CLIENT_ID
    • GOOGLE_CLIENT_SECRET GOOGLE_CLIENT_SECRET
    • GOOGLE_REFRESH_TOKEN GOOGLE_REFRESH_TOKEN

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Prerequisites

- Rust (latest stable version)
- Google Cloud Project with Drive and Sheets APIs enabled
- OAuth 2.0 credentials configured for your Google Cloud Project

list_files

List and filter Drive files with customizable parameters.

read_values

Read spreadsheet data with dimension control.

write_values

Write data to spreadsheets.

create_spreadsheet

Create new spreadsheets with a custom title and multiple sheets.

clear_values

Clear ranges in spreadsheets.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "google workspace": {
            "env": {
                "ACCESS_TOKEN": "ACCESS_TOKEN",
                "GOOGLE_CLIENT_ID": "GOOGLE_CLIENT_ID",
                "GOOGLE_CLIENT_SECRET": "GOOGLE_CLIENT_SECRET",
                "GOOGLE_REFRESH_TOKEN": "GOOGLE_REFRESH_TOKEN"
            },
            "args": [
                "drive",
                "--access-token",
                "$${ACCESS_TOKEN}"
            ],
            "command": "mcp-google"
        }
    }
}

Linux

{
    "env": {
        "ACCESS_TOKEN": "ACCESS_TOKEN",
        "GOOGLE_CLIENT_ID": "GOOGLE_CLIENT_ID",
        "GOOGLE_CLIENT_SECRET": "GOOGLE_CLIENT_SECRET",
        "GOOGLE_REFRESH_TOKEN": "GOOGLE_REFRESH_TOKEN"
    },
    "args": [
        "drive",
        "--access-token",
        "$${ACCESS_TOKEN}"
    ],
    "command": "mcp-google"
}

Macos

{
    "env": {
        "ACCESS_TOKEN": "ACCESS_TOKEN",
        "GOOGLE_CLIENT_ID": "GOOGLE_CLIENT_ID",
        "GOOGLE_CLIENT_SECRET": "GOOGLE_CLIENT_SECRET",
        "GOOGLE_REFRESH_TOKEN": "GOOGLE_REFRESH_TOKEN"
    },
    "args": [
        "drive",
        "--access-token",
        "$${ACCESS_TOKEN}"
    ],
    "command": "mcp-google"
}

Windows

{
    "env": {
        "ACCESS_TOKEN": "ACCESS_TOKEN",
        "GOOGLE_CLIENT_ID": "GOOGLE_CLIENT_ID",
        "GOOGLE_CLIENT_SECRET": "GOOGLE_CLIENT_SECRET",
        "GOOGLE_REFRESH_TOKEN": "GOOGLE_REFRESH_TOKEN"
    },
    "args": [
        "/c",
        "mcp-google",
        "drive",
        "--access-token",
        "%ACCESS_TOKEN%"
    ],
    "command": "cmd"
}

Google Drive & Sheets MCP Server

A Model Context Protocol (MCP) server built in Rust for interacting with Google Drive and Google Sheets. This tool provides MCP-compatible interfaces for Google Workspace services, allowing it to be used as part of larger agent workflows and compositions.

Features

Google Drive Operations

- List files in Google Drive with filtering options: - Filter by MIME type - Custom search queries - Configurable page size - Custom ordering

Google Sheets Operations

- Read data from Google Sheets with options: - Specify range - Choose major dimension (ROWS or COLUMNS) - Write data to Google Sheets - Create new spreadsheets with: - Custom title - Multiple sheets - Clear values from ranges in spreadsheets

MCP Integration

This server implements the Model Context Protocol (MCP), making it compatible with agent frameworks like Distri. Each service exposes its capabilities as MCP tools:

Drive Tools

- list_files: List and filter Drive files with customizable parameters - Available capabilities exposed via resources/list endpoint

Sheets Tools

- read_values: Read spreadsheet data with dimension control - write_values: Write data to spreadsheets - create_spreadsheet: Create new spreadsheets - clear_values: Clear ranges in spreadsheets - Available capabilities exposed via resources/list endpoint

Prerequisites

- Rust (latest stable version)
- Google Cloud Project with Drive and Sheets APIs enabled
- OAuth 2.0 credentials configured for your Google Cloud Project

Installation

Install the mcp-google binary directly from GitHub using Cargo:

cargo install --git https://github.com/distrihub/mcp-google-workspace.git

This will install the mcp-google command to your system.

Configuration

Before using the server, you need to:

1. Set up a Google Cloud Project
2. Enable Google Drive and Google Sheets APIss
3. Create OAuth 2.0 credentials
4. Set up your environment variables:
- ACCESS_TOKEN: Your Google OAuth access token
- GOOGLE_CLIENT_ID: Your OAuth client ID
- GOOGLE_CLIENT_SECRET: Your OAuth client secret
- GOOGLE_REFRESH_TOKEN: Your OAuth refresh token

Usage

As MCP Server

The servers can be started independently and will communicate using the MCP protocol over stdio:

Start the Drive MCP server:

mcp-google drive --access-token <your-access-token>

Start the Sheets MCP server:

mcp-google sheets --access-token <your-access-token>

Using with Distri

This server can be used as part of a Distri agent configuration:

```yaml

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.