# Google Workspace MCP Server

> Google Workspace MCP Server is an open-source MCP server for productivity. MCP server letting AI assistants read and edit Google Sheets, Docs, Slides and Drive. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, self-hosted
- **Repository:** https://github.com/takiguchi-yu/google-workspace-mcp-server
- **MCP Registry name:** io.github.takiguchi-yu/google-workspace-mcp-server
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

The README describes this server as a way for AI assistants such as GitHub Copilot to operate Google Workspace files, covering Sheets, Docs, Slides and Drive. Its distinguishing feature is handling several Google accounts from one server: each tool takes an account argument using a label such as work or private, and a default account is used when it is omitted.

Each account can authenticate either with OAuth, acting as the user and reaching the whole Drive, or with a service account that needs no browser consent but only sees files explicitly shared with it. The README notes that service accounts cannot create new files. Credentials and tokens are stored together in a single local configuration directory.

The tool set is large, with dozens of Sheets operations (formatting, filters, validation, conditional formats, CSV import), many Slides editing tools, a Markdown export for Docs, and basic Drive search and listing. Setup requires creating OAuth credentials in Google Cloud and running a setup command per account.

## Features

- **Multiple account support:** Switch between work, personal or other Google accounts with a label on each tool call.
- **OAuth or service accounts:** Choose per account between user authorization with full Drive access or a service account limited to shared files.
- **Detailed Sheets editing:** Read, write, sort, filter, format and validate spreadsheet ranges, plus import CSV or TSV data.
- **Slides manipulation:** Add and edit text, shapes, tables, images and lines, and replace placeholder text across a presentation.
- **Docs as Markdown:** Fetch a Google Doc's body converted to Markdown, including headings, lists and tables.
- **Docker deployment:** The README documents running the server in a container with a helper script for updating pinned image versions.

## Good for

- Letting a coding assistant update a shared spreadsheet's data and formatting
- Filling Slides templates with text from other sources using batch replacement
- Reading a Google Doc as Markdown to give an assistant document context
- Switching between a work and a personal Google account within one MCP setup
- Searching and listing Drive files from inside an AI client

## Install

### Claude Code (Terminal)

```sh
claude mcp add google-workspace-mcp-server -- npx -y @takiguchi-yu/google-workspace-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "google-workspace-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@takiguchi-yu/google-workspace-mcp-server"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "google-workspace-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@takiguchi-yu/google-workspace-mcp-server"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "google-workspace-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@takiguchi-yu/google-workspace-mcp-server"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "google-workspace-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@takiguchi-yu/google-workspace-mcp-server"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "google-workspace-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@takiguchi-yu/google-workspace-mcp-server"
      ]
    }
  }
}
```

## Tools

- `accounts_list`: List registered Google accounts.
- `sheets_read_sheet_values`: Read values from a cell range.
- `sheets_update_sheet_values`: Update values in a cell range.
- `sheets_import_csv`: Import a CSV or TSV file into a spreadsheet.
- `docs_get_document`: Get a Google Doc body as Markdown.
- `slides_create_presentation`: Create a presentation.
- `slides_replace_all_text`: Replace text across a presentation.
- `drive_search_files`: Search Drive files.
- `drive_list_items`: List items in a Drive folder.

## FAQ

### Which Google services does it cover?

According to the README, it covers Google Sheets, Google Docs, Google Slides and Google Drive.

### What is the difference between OAuth and service account mode?

The README says OAuth needs browser authorization and can read and write the whole Drive, while a service account needs no browser step but only accesses files shared with it and cannot create new files.

### How are multiple accounts handled?

Each tool accepts an account argument with a label such as work or private; if omitted, the default account is used.

### Where are credentials stored?

The README lists a single directory under the home folder holding account settings, a shared OAuth client file, and per-account tokens or service account keys.

### Is Google Workspace MCP Server free?

Yes. Google Workspace MCP Server is open source, so you can use and self-host it for free.

### How do I add Google Workspace MCP Server to Claude Code?

Run this command in your terminal: claude mcp add google-workspace-mcp-server -- npx -y @takiguchi-yu/google-workspace-mcp-server

### What are the best alternatives to Google Workspace MCP Server?

The closest alternatives to Google Workspace MCP Server are Google Workspace MCP, Google Workspace MCP, MCP Gee Sweet, Gws Connector and Google Workspace (gsuite-sdk).

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Google Workspace MCP](https://ai-powered.com/mcp/google-workspace-mcp-2): Google Workspace MCP is an MCP server for productivity.
- [Google Workspace MCP](https://ai-powered.com/mcp/google-workspace-mcp): Google Workspace MCP is an open-source MCP server for productivity.
- [MCP Gee Sweet](https://ai-powered.com/mcp/mcp-gee-sweet): MCP Gee Sweet is a free MCP server for productivity.
- [Gws Connector](https://ai-powered.com/mcp/gws-connector): Gws Connector is an open-source MCP server for productivity.
- [Google Workspace (gsuite-sdk)](https://ai-powered.com/mcp/google-workspace-gsuite-sdk): Google Workspace (gsuite-sdk) is an open-source MCP server for productivity.
- [Google Keep MCP](https://ai-powered.com/mcp/google-keep-mcp): Google Keep MCP is an open-source MCP server for productivity.
- [Workspace Operator](https://ai-powered.com/mcp/workspace-operator): Workspace Operator is an open-source MCP server for productivity.
- [Google Sheets MCP Server](https://ai-powered.com/mcp/google-sheets-mcp-server): Google Sheets MCP Server is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/google-workspace-mcp-server-2
