Google MCP Server

An MCP (Model Context Protocol) server for reading Google Docs, Sheets, and Slides, and the comments and suggested edits on them.
Features
Read-only access to Google Docs, Sheets, Slides, and Drive comments via MCP tools. Two upload tools exist only if you turn on write mode.
- get_document_metadata - Get document metadata (title, word count, element counts)
- get_document_content - Get structured content (headings, paragraphs, images, tables)
- get_document_text - Get all text as a single plain text string
- get_document_paragraphs - Get text organized by paragraphs
- get_document_suggestions - Get text split into original, inserted, and deleted by suggested edits
- get_file_comments - List a file's comments with quoted text, resolved state, and replies
- upload_file - Upload a local file, optionally converting it to a Doc, Sheet, or Slides file (write mode only)
- update_file - Replace a Drive file's content, keeping its ID (write mode only)
Write mode is off by default. Start the server with --enable-write (or MCP_GOOGLE_ENABLE_WRITE=true) to register the two upload tools; they read local files only from --upload-root. See Google Drive tools.
- get_spreadsheet_metadata - Get spreadsheet metadata (title, sheet count, locale, time zone)
- list_sheets - List all sheets with their properties
- get_sheet_values - Get cell values from a specific range
- get_sheet_data - Get all data from a specific sheet
- get_multiple_ranges - Batch get values from multiple ranges
- get_presentation - Get presentation metadata (title, slide count, locale, revision ID)
- list_slides - List all slides with titles and element counts
- get_slide - Get slide content and element details by index or object ID
- get_slide_notes - Get speaker notes by slide index or object ID
- get_presentation_content - Get all slides' text and images in one call (ideal for AI)
Architecture
This server is built on omniskill, making its Google Docs, Sheets, and Slides skills composable building blocks that can be reused in multi-service MCP servers.
Composable Skills
The skills in this repository can be imported and combined with other skills:
import (
"github.com/plexusone/mcp-google/skills/docs"
"github.com/plexusone/mcp-google/skills/sheets"
"github.com/plexusone/mcp-google/skills/slides"
runtime "github.com/plexusone/omniskill/mcp/server"
)
// Create runtime
rt := runtime.New(&mcp.Implementation{
Name: "work-mcp-server",
Version: "v1.0.0",
}, nil)
// Add Google skills
docsSkill := docs.New(googleHTTPClient)
docsSkill.Init(ctx)
rt.RegisterSkill(docsSkill)
sheetsSkill := sheets.New(googleHTTPClient)
sheetsSkill.Init(ctx)
rt.RegisterSkill(sheetsSkill)
slidesSkill := slides.New(googleHTTPClient)
slidesSkill.Init(ctx)
rt.RegisterSkill(slidesSkill)
// Add other skills (Slack, Jira, GitHub, etc.)
rt.RegisterSkill(slackSkill)
rt.RegisterSkill(jiraSkill)
// Run server
rt.ServeStdio(ctx)
This enables building unified MCP servers that combine multiple services while keeping each service's implementation modular and maintainable.
Requirements
- Go 1.26+
- Google Cloud service account with Docs, Sheets, and Slides API access
Installation
go install github.com/plexusone/mcp-google/cmd/mcp-google@latest
Or build from source:
git clone https://github.com/plexusone/mcp-google.git
cd mcp-google
go build ./cmd/mcp-google
Setup
1. Create a Google Cloud Service Account
- Go to the Google Cloud Console
- Create a new project or select an existing one
- Enable the Google Docs API, Google Sheets API, and Google Slides API
- Create a service account with no special roles
- Download the JSON credentials file
2. Share Documents with the Service Account
Share any documents, spreadsheets, or presentations you want to access with the service account's email address (found in the credentials JSON as client_email).
Usage
Option 1: Google Service Account Credentials
Use a standard Google Cloud service account JSON file:
mcp-google --credentials /path/to/service-account.json
Or using an environment variable:
export GOOGLE_CREDENTIALS_FILE=/path/to/service-account.json
mcp-google
Option 2: goauth CredentialsSet
Use a goauth CredentialsSet file, which can store multiple credentials:
mcp-google --goauth-credentials-file /path/to/credentials.json --goauth-credentials-account myaccount
Or using environment variables:
export GOAUTH_CREDENTIALS_FILE=/path/to/credentials.json
export GOAUTH_CREDENTIALS_ACCOUNT=myaccount
mcp-google
The CredentialsSet entry should be of type gcpsa with appropriate scopes:
{
"credentials": {
"myaccount": {
"type": "gcpsa",
"gcpsa": {
"gcpCredentials": {
"type": "service_account",
"project_id": "...",
"private_key_id": "...",
"private_key": "...",
"client_email": "...",
"client_id": "..."
},
"scopes": [
"https://www.googleapis.com/auth/documents.readonly",
"https://www.googleapis.com/auth/spreadsheets.readonly",
"https://www.googleapis.com/auth/presentations.readonly",
"https://www.googleapis.com/auth/drive.readonly"
]
}
}
}
}
Option 3: Vault-Backed Credentials
Use omnitoken with omnivault-desktop for secure credential storage in password managers.
Supported vault providers:
| Provider |
URI Pattern |
Requirements |
| 1Password |
op://vault |
OP_SERVICE_ACCOUNT_TOKEN env var |
| Bitwarden |
bw://org-id |
BW_ACCESS_TOKEN and BW_ORGANIZATION_ID env vars |
| File |
file:///path |
None |
| Env |
env://PREFIX_ |
None |
1Password Example
export OP_SERVICE_ACCOUNT_TOKEN="ops_..."
mcp-google --vault op://MyVault --credentials-name google
Bitwarden Example
export BW_ACCESS_TOKEN="..."
export BW_ORGANIZATION_ID="..."
mcp-google --vault bw://org-id --credentials-name google
File Vault Example
mcp-google --vault file:///path/to/secrets --credentials-name google
The CLI exposes one subcommand per MCP tool, plus serve and version.
mcp-google --help
mcp-google get-document-metadata <document-id-or-url> --credentials /path/to/service-account.json
mcp-google get-document-content <document-id-or-url> --include-metadata --include-images --include-tables -o pretty
mcp-google get-spreadsheet-metadata <spreadsheet-id-or-url> --credentials /path/to/service-account.json
mcp-google get-sheet-data <spreadsheet-id-or-url> --sheet-name "Sheet1" -o pretty
mcp-google get-presentation <presentation-id> --credentials /path/to/service-account.json
Use mcp-google <command> --help for command-specific flags. See docs/cli.md for the full CLI reference.
Claude Desktop Configuration
Add to your Claude Desktop configuration (claude_desktop_config.json):
With Google Service Account
{
"mcpServers": {
"google": {
"command": "/path/to/mcp-google",
"env": {
"GOOGLE_CREDENTIALS_FILE": "/path/to/service-account.json"
}
}
}
}
With goauth CredentialsSet
{
"mcpServers": {
"google": {
"command": "/path/to/mcp-google",
"env": {
"GOAUTH_CREDENTIALS_FILE": "/path/to/credentials.json",
"GOAUTH_CREDENTIALS_ACCOUNT": "myaccount"
}
}
}
}
With 1Password
{
"mcpServers": {
"google": {
"command": "/path/to/mcp-google",
"env": {
"OP_SERVICE_ACCOUNT_TOKEN": "ops_...",
"OMNITOKEN_VAULT_URI": "op://MyVault",
"OMNITOKEN_CREDENTIALS_NAME": "google"
}
}
}
}
See docs/configuration/claude-desktop.md for more options including Bitwarden.
HTTP Transport (ID-JAG Authorization)
By default mcp-google serves over stdio. It can also serve streamable HTTP as a pure OAuth resource server, verifying bearer tokens issued by an external authorization server (enterprise IdP / ID-JAG delegation-chain tokens):
mcp-google serve \
--http :8080 \
--idjag-issuer https://idp.example.com \
--idjag-audience https://mcp-google.example.com
Verified identity (subject, RFC 8693 act chain, scope) is audit-logged on every tool call, and calls are gated by scope (docs:read, sheets:read, slides:read, drive:read, and drive:write in write mode) when the token carries one. Each tool maps to exactly one required scope through an explicit per-tool table; when a scope claim is present, a tool without a mapping is denied. See docs/configuration/http-transport.md for the full flag/env reference.
Get metadata about a document.
Input:
document_id (required) - The ID or URL of the Google Doc
Output:
title - Document title
document_id - Document ID
revision_id - Current revision ID
word_count - Approximate word count
char_count - Character count
image_count - Number of images
table_count - Number of tables
header_count - Number of headers
footer_count - Number of footers
get_document_content
Get the full structured content of a document.
Input:
document_id (required) - The ID or URL of the Google Doc
include_images (optional) - Include image information (default: false)
include_tables (optional) - Include table content (default: false)
include_headers (optional) - Include document headers (default: false)
include_footers (optional) - Include document footers (default: false)
Output:
title - Document title
sections - Array of content sections:
type - Section type ("heading", "paragraph")
level - Heading level (1-6, for headings only)
text - Section text content
style_id - Style identifier (e.g., "HEADING_1", "NORMAL_TEXT")
images - Array of images (if requested):
object_id - Image element ID
content_uri - Direct URL to image
source_uri - Original source URL
title - Image title
description - Image description
tables - Array of tables (if requested):
rows - Number of rows
columns - Number of columns
cells - 2D array of cell text content
headers - Array of header text (if requested)
footers - Array of footer text (if requested)
get_document_text
Get all text from a document as a single plain text string.
Input:
document_id (required) - The ID or URL of the Google Doc
Output:
title - Document title
text - Full document text
get_document_paragraphs
Get text organized by paragraphs.
Input:
document_id (required) - The ID or URL of the Google Doc
Output:
title - Document title
paragraphs - Array of paragraph text strings
Get metadata about a spreadsheet.
Input:
spreadsheet_id (required) - The ID or URL of the Google Sheets spreadsheet
Output:
spreadsheet_id - Spreadsheet ID
title - Spreadsheet title
locale - Spreadsheet locale
time_zone - Spreadsheet time zone
sheet_count - Number of sheets
url - Spreadsheet URL
list_sheets
List all sheets in a spreadsheet with their properties.
Input:
spreadsheet_id (required) - The ID or URL of the Google Sheets spreadsheet
Output:
spreadsheet_id - Spreadsheet ID
title - Spreadsheet title
sheets - Array of sheet information:
index - Sheet index
sheet_id - Sheet GID
title - Sheet title
sheet_type - Sheet type (GRID, etc.)
hidden - Whether sheet is hidden
row_count - Number of rows
column_count - Number of columns
frozen_row_count - Number of frozen rows (if any)
frozen_column_count - Number of frozen columns (if any)
get_sheet_values
Get cell values from a specific range.
Input:
spreadsheet_id (required) - The ID or URL of the Google Sheets spreadsheet
range (required) - A1 notation range (e.g., 'Sheet1!A1:D10', 'A:D', 'A1:D10')
sheet_index (optional) - Zero-based sheet index (used when range doesn't include sheet name)
sheet_name (optional) - Sheet name (mutually exclusive with sheet_index)
value_format (optional) - Output format: 'formatted' (default), 'typed', 'raw'
Output:
spreadsheet_id - Spreadsheet ID
range - Resolved range
values - 2D array of cell values (format depends on value_format)
get_sheet_data
Get all data from a specific sheet.
Input:
spreadsheet_id (required) - The ID or URL of the Google Sheets spreadsheet
sheet_index (optional) - Zero-based sheet index (default: 0)
sheet_name (optional) - Sheet name (mutually exclusive with sheet_index and sheet_gid)
sheet_gid (optional) - Sheet GID from URL (mutually exclusive with sheet_index and sheet_name)
value_format (optional) - Output format: 'formatted' (default), 'typed', 'raw'
include_metadata (optional) - Include sheet metadata (default: false)
Output:
spreadsheet_id - Spreadsheet ID
sheet_name - Sheet name
range - Data range
values - 2D array of cell values
metadata - Sheet metadata (if requested)
get_multiple_ranges
Batch get values from multiple ranges in a single request.
Input:
spreadsheet_id (required) - The ID or URL of the Google Sheets spreadsheet
ranges (required) - Array of A1 notation ranges
value_format (optional) - Output format: 'formatted' (default), 'typed', 'raw'
Output:
spreadsheet_id - Spreadsheet ID
ranges - Array of range results, each containing:
range - Resolved range
values - 2D array of cell values
get_presentation
Get metadata about a presentation.
Input:
presentation_id (required) - The ID of the Google Slides presentation
Output:
title - Presentation title
slide_count - Number of slides
locale - Presentation locale
revision_id - Current revision ID
list_slides
List all slides in a presentation.
Input:
presentation_id (required) - The ID of the Google Slides presentation
Output:
slides - Array of slide information:
object_id - Slide's unique identifier
index - Zero-based slide index
title - Slide title (if present)
element_count - Number of elements on the slide
get_slide
Get the content of a specific slide.
Input:
presentation_id (required) - The ID of the Google Slides presentation
slide_index (optional) - Zero-based slide index
slide_object_id (optional) - Slide's object ID
One of slide_index or slide_object_id must be provided.
Output:
text_content - Array of text strings from the slide
element_summary - Array of element details:
object_id - Element's unique identifier
element_type - Type of element (shape, image, table, etc.)
description - Element description or text preview
get_slide_notes
Get the speaker notes for a specific slide.
Input:
presentation_id (required) - The ID of the Google Slides presentation
slide_index (optional) - Zero-based slide index
slide_object_id (optional) - Slide's object ID
One of slide_index or slide_object_id must be provided.
Output:
notes - Speaker notes text
get_presentation_content
Get all slide content in a single call - ideal for AI analysis of the entire presentation.
Input:
presentation_id (required) - The ID of the Google Slides presentation
include_notes (optional) - Include speaker notes for each slide (default: false)
Output:
title - Presentation title
slides - Array of slide content:
index - Zero-based slide index
object_id - Slide's unique identifier
title - Slide title (if present)
text_content - Array of text strings from the slide
images - Array of images:
object_id - Image element ID
content_url - Direct URL to image (valid ~30 minutes)
source_url - Original source URL (if available)
alt_text - Image description
notes - Speaker notes (if include_notes is true)
Finding Document IDs
Documents
The document ID is in the URL when viewing a document:
https://docs.google.com/document/d/DOCUMENT_ID_HERE/edit
Note: Google Docs tools accept either the document ID or the full URL, including URLs with query strings and anchors:
https://docs.google.com/document/d/DOCUMENT_ID_HERE/edit?tab=t.0#heading=h.xyz
Spreadsheets
The spreadsheet ID is in the URL when viewing a spreadsheet:
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID_HERE/edit
Note: Google Sheets tools accept either the spreadsheet ID or the full URL. URLs may include sheet GID and range:
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID_HERE/edit#gid=123&range=A1:D10
Presentations
The presentation ID is in the URL when viewing a presentation:
https://docs.google.com/presentation/d/PRESENTATION_ID_HERE/edit
License
MIT