Google Workspace MCP Server
MCP server letting AI assistants read and edit Google Sheets, Docs, Slides and Drive
- Pricing
- Open source
- Platforms
- API, CLI, self-hosted
- Runs
- Locally
- Version
- 0.9.0
- Listing updated
- today
Similar MCP servers
About Google Workspace MCP Server
Google Workspace MCP Server is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add google-workspace-mcp-server -- npx -y @takiguchi-yu/google-workspace-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"google-workspace-mcp-server": {
"command": "npx",
"args": [
"-y",
"@takiguchi-yu/google-workspace-mcp-server"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"google-workspace-mcp-server": {
"command": "npx",
"args": [
"-y",
"@takiguchi-yu/google-workspace-mcp-server"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"google-workspace-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@takiguchi-yu/google-workspace-mcp-server"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"google-workspace-mcp-server": {
"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-server": {
"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 (9)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Open source
Google Workspace MCP Server 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.
