Google Workspace MCP
MCP server letting AI assistants work with Google Slides, Sheets, Docs and Drive across
- 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-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"google-workspace-mcp": {
"command": "npx",
"args": [
"-y",
"@takiguchi-yu/google-workspace-mcp-server"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"google-workspace-mcp": {
"command": "npx",
"args": [
"-y",
"@takiguchi-yu/google-workspace-mcp-server"
]
}
}
}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.
