Skip to content
MCP server

Google Workspace MCP

MCP server letting AI assistants work with Google Slides, Sheets, Docs and Drive across

Runs locallyStatus and history
Install
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.0.5
Listing updated
today

Similar MCP servers

About Google Workspace MCP

Google Workspace MCP is an MCP server for productivity. It runs locally on your machine and is started by your AI client.

The README describes this as a bridge that lets AI assistants such as GitHub Copilot read and change Google Workspace files. Its main distinction is handling several Google accounts from one server: each tool takes an account argument, and labels like work or private select which account is used, with a default when omitted.

Each account can authenticate with OAuth as a user or with a service account. The README notes the trade-off: OAuth gives access to the whole Drive and can create new files, while a service account only reaches files explicitly shared with it and cannot create new ones.

The tool set covers Sheets (about thirty operations including formatting, filters, sorting, CSV import and conditional formats), Slides (text, shapes, tables, images and layout changes), Docs (reading a document as Markdown) and basic Drive search and listing. It is aimed at people who keep work and personal Google accounts and want an assistant to handle spreadsheets and presentations.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@takiguchi-yu/google-workspace-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@takiguchi-yu/google-workspace-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (60)

Taken from the project documentation; the running server may differ.

accounts_list
List the registered Google accounts.
sheets_list_spreadsheets
List spreadsheets.
sheets_get_spreadsheet_info
Get spreadsheet details including sheet list and properties.
sheets_read_sheet_values
Read values from a cell range.
sheets_update_sheet_values
Update values in a cell range.
sheets_batch_update_sheet_values
Update several cell ranges at once.
sheets_create_spreadsheet
Create a new spreadsheet.
sheets_add_sheet
Add a sheet to a spreadsheet.
sheets_delete_sheet
Delete a sheet with its contents.
sheets_duplicate_sheet
Duplicate a sheet including formatting and formulas.
sheets_update_sheet_properties
Change sheet name, tab colour, order or visibility.
sheets_append_values
Append rows to existing data.
sheets_clear_sheet_values
Clear values in a cell range.
sheets_import_csv
Import a CSV or TSV file into a spreadsheet.
sheets_insert_dimension
Insert rows or columns at a position.
sheets_delete_dimension
Delete rows or columns in a range.
sheets_sort_range
Sort a range by multiple column keys.
sheets_set_basic_filter
Set a filter on a range.
sheets_clear_basic_filter
Remove a filter.
sheets_set_data_validation
Set data validation rules.
sheets_clear_data_validation
Remove data validation rules.
sheets_format_cells
Change cell formatting.
sheets_set_borders
Set or remove cell borders.
sheets_merge_cells
Merge or unmerge cells.
sheets_resize_dimension
Resize columns or rows.
sheets_freeze_panes
Freeze leading rows or columns.
sheets_add_conditional_format
Add a conditional formatting rule.
sheets_delete_conditional_format
Delete a conditional formatting rule by index.
sheets_list_conditional_formats
List conditional formatting rules.
docs_get_document
Get a Google Doc body as Markdown.
slides_create_presentation
Create a presentation.
slides_get_presentation
Get presentation contents.
slides_list_presentations
List presentations.
slides_get_page
Get details of a slide.
slides_update_text_shape
Update or append text in a text element.
slides_add_text_box
Add a text box to a slide.
slides_delete_element
Delete a slide element.
slides_duplicate_slide
Duplicate a slide.
slides_add_shape
Add a shape to a slide.
slides_update_slide_properties
Update slide properties such as background colour.
slides_batch_update_presentation
Run several update requests in one batch.
slides_update_text_style
Change text font, size, colour and weight.
slides_update_shape_style
Change shape fill and outline.
slides_insert_image
Insert an image from a public URL.
slides_replace_all_text
Replace text throughout a presentation.
slides_add_slide
Add a slide with a chosen layout.
slides_update_paragraph_style
Change paragraph alignment, spacing and indentation.
slides_create_paragraph_bullets
Turn paragraphs into bulleted or numbered lists.
slides_delete_paragraph_bullets
Remove bullets from paragraphs.
slides_update_element_transform
Change element position, size and rotation.
slides_update_elements_z_order
Change stacking order of elements.
slides_add_line
Add a line or arrow between two points.
slides_group_elements
Group several elements.
slides_ungroup_elements
Ungroup elements.
slides_add_table
Add a table from a two-dimensional array.
slides_update_table_cells
Change table cell fill and vertical alignment.
slides_update_table_borders
Set table borders.
slides_resize_table
Change table row heights and column widths.
slides_insert_table_dimension
Insert table rows or columns.
slides_delete_table_dimension
Delete table rows or columns.

What it does

Multiple account support
Each tool accepts an account label so one server can switch between work and personal Google accounts.
OAuth or service accounts
Accounts can be authorised as a user through OAuth or through a service account that needs no browser approval.
Extensive Sheets tools
Covers reading, writing, appending, sorting, filtering, formatting, merging and conditional formatting of spreadsheet ranges.
Slides editing operations
Adds and edits text, shapes, lines, tables and images, and can replace text across a presentation.
Docs reading as Markdown
Retrieves the body of a Google Doc converted to Markdown, including headings, lists and tables.
Drive search and listing
Searches files with query syntax and lists the contents of a folder.

Good for

  • Filling a template spreadsheet with data from an assistant's session
  • Generating a presentation from a set of slides and replacing placeholder text
  • Importing CSV exports into a Google Sheet and formatting the result
  • Reading a Google Doc as Markdown to summarise or revise it
  • Switching between work and personal Google accounts from one assistant

Google Workspace MCP 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 accounts here?

The README says OAuth needs browser authorisation and can read and write all of Drive and create new files, while a service account needs no browser step but only reaches files shared with it and cannot create new files.

Which AI assistants does it work with?

The README names GitHub Copilot as an example of an assistant that can use it, and mentions Claude Code in its Docker update instructions.

Is it free to use?

The content does not state a price or licence beyond the npm and GitHub distribution.

How do I add Google Workspace MCP to Claude Code?

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

What are the best alternatives to Google Workspace MCP?

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

Where this comes from

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

How AIPoweredBot checks servers