adelaidasofia avatar

Multi-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, token

adelaidasofia/google-workspace-mcp

Connects Claude to Gmail, Calendar, Drive, Docs, and Sheets with 61 tools across multi-account OAuth. Returns compact metadata by default (subject lines, file names, event summaries) and fetches full bodies or content only when you ask, keeping token usage down. Handles Send-As identities for email aliases, supports threaded replies, calendar free/busy checks, Drive comments and permissions, Sheets named ranges and conditional formatting, and Docs tracked changes. Stores refresh tokens in macOS Keychain instead of plaintext. Built because the official Claude connector locks you to one account and pulls entire message bodies upfront. Useful when you're juggling work and personal Google accounts or need fine-grained control over what gets loaded into context.

GitHub stars
1
tools
63
auth
Secret needed
transport
STDIO
env vars
2
last updated
May 20, 2026

Tools

63 tools

Public tool metadata for what this MCP can expose to an agent.

gws_account_addbrowser OAuth flow, adds a new authorized mailbox

browser OAuth flow, adds a new authorized mailbox

No parameter schema in public metadata yet.

gws_account_listlist authorized accounts + default

list authorized accounts + default

No parameter schema in public metadata yet.

gws_account_removeremove local credential (doesn't revoke Google-side)

remove local credential (doesn't revoke Google-side)

No parameter schema in public metadata yet.

gmail_searchsearch with Gmail operators. Compact response.

search with Gmail operators. Compact response.

No parameter schema in public metadata yet.

gmail_readread one message or full thread. Bodies opt-in.

read one message or full thread. Bodies opt-in.

No parameter schema in public metadata yet.

gmail_sendsend mail, optional `from_alias` for Send-As identities

send mail, optional `from_alias` for Send-As identities

No parameter schema in public metadata yet.

gmail_draftcreate a draft

create a draft

No parameter schema in public metadata yet.

gmail_replyreply (preserves thread + headers), optional reply_all

reply (preserves thread + headers), optional reply_all

No parameter schema in public metadata yet.

gmail_labels_listlist all labels

list all labels

No parameter schema in public metadata yet.

gmail_label_applybatch add/remove labels

batch add/remove labels

No parameter schema in public metadata yet.

gmail_archivebatch archive (remove INBOX)

batch archive (remove INBOX)

No parameter schema in public metadata yet.

gmail_trashbatch move to trash

batch move to trash

No parameter schema in public metadata yet.

gmail_sendas_listlist Send-As identities on this mailbox

list Send-As identities on this mailbox

No parameter schema in public metadata yet.

gmail_attachments_listlist a message's attachments (filename, mime type, size)

list a message's attachments (filename, mime type, size)

No parameter schema in public metadata yet.

gmail_attachment_savedownload one attachment to a local file, path returned for direct reading

download one attachment to a local file, path returned for direct reading

No parameter schema in public metadata yet.

cal_list_calendarslist all calendars

list all calendars

No parameter schema in public metadata yet.

cal_list_eventslist upcoming events (compact by default, `verbose=True` for full)

list upcoming events (compact by default, `verbose=True` for full)

No parameter schema in public metadata yet.

cal_create_eventcreate event, optional Google Meet link

create event, optional Google Meet link

No parameter schema in public metadata yet.

cal_update_eventpartial-update fields

partial-update fields

No parameter schema in public metadata yet.

cal_delete_eventdelete

delete

No parameter schema in public metadata yet.

cal_freebusycheck busy windows for scheduling

check busy windows for scheduling

No parameter schema in public metadata yet.

cal_respondaccept/decline/tentative

accept/decline/tentative

No parameter schema in public metadata yet.

drive_searchfree-text or raw Drive q-syntax. Metadata-only response.

free-text or raw Drive q-syntax. Metadata-only response.

No parameter schema in public metadata yet.

drive_read_filemetadata by default; `include_content=True` for body

metadata by default; `include_content=True` for body

No parameter schema in public metadata yet.

drive_list_folderdirect children of a folder (`'root'` for My Drive)

direct children of a folder (`'root'` for My Drive)

No parameter schema in public metadata yet.

drive_create_foldercreate a folder under an optional parent

create a folder under an optional parent

No parameter schema in public metadata yet.

drive_uploadupload a local file, optional `convert_to_google`

upload a local file, optional `convert_to_google`

No parameter schema in public metadata yet.

drive_movechange parent folder

change parent folder

No parameter schema in public metadata yet.

drive_renamerename a file or folder

rename a file or folder

No parameter schema in public metadata yet.

drive_sharegrant reader/commenter/writer/etc. access by email

grant reader/commenter/writer/etc. access by email

No parameter schema in public metadata yet.

drive_trashsoft delete (recoverable)

soft delete (recoverable)

No parameter schema in public metadata yet.

drive_untrashrestore from Trash

restore from Trash

No parameter schema in public metadata yet.

drive_permission_listlist everyone with access to a file

list everyone with access to a file

No parameter schema in public metadata yet.

drive_permission_updatechange a grantee's role

change a grantee's role

No parameter schema in public metadata yet.

drive_permission_deleterevoke a permission

revoke a permission

No parameter schema in public metadata yet.

drive_shared_drives_listlist shared drives this account accesses

list shared drives this account accesses

No parameter schema in public metadata yet.

drive_comments_listlist comments on any Drive file (Doc/Sheet/Slide/upload)

list comments on any Drive file (Doc/Sheet/Slide/upload)

No parameter schema in public metadata yet.

drive_comment_addadd a comment, optional anchor

add a comment, optional anchor

No parameter schema in public metadata yet.

drive_comment_replyreply to a comment

reply to a comment

No parameter schema in public metadata yet.

drive_comment_resolvemark a comment resolved

mark a comment resolved

No parameter schema in public metadata yet.

docs_createnew Doc, optional initial body and parent folder

new Doc, optional initial body and parent folder

No parameter schema in public metadata yet.

docs_readflat text by default; `structured=True` for full Docs API tree

flat text by default; `structured=True` for full Docs API tree

No parameter schema in public metadata yet.

docs_appendappend text to end of body

append text to end of body

No parameter schema in public metadata yet.

docs_insert_atinsert text at a specific index

insert text at a specific index

No parameter schema in public metadata yet.

docs_replace_textfind-and-replace, returns count replaced

find-and-replace, returns count replaced

No parameter schema in public metadata yet.

docs_exportexport to markdown / pdf / docx / rtf / plain

export to markdown / pdf / docx / rtf / plain

No parameter schema in public metadata yet.

docs_suggestions_listlist pending tracked-change suggestions

list pending tracked-change suggestions

No parameter schema in public metadata yet.

docs_suggestions_accept_allaccept all suggestions (rewrites Doc)

accept all suggestions (rewrites Doc)

No parameter schema in public metadata yet.

docs_suggestions_reject_allreject all suggestions (rewrites Doc)

reject all suggestions (rewrites Doc)

No parameter schema in public metadata yet.

sheets_createnew workbook, optional parent folder

new workbook, optional parent folder

No parameter schema in public metadata yet.

sheets_list_sheetslist tabs with row/col dimensions

list tabs with row/col dimensions

No parameter schema in public metadata yet.

sheets_add_sheetadd a new tab to an existing workbook

add a new tab to an existing workbook

No parameter schema in public metadata yet.

sheets_read_rangeread A1 range. `FORMULA` / `UNFORMATTED_VALUE` options.

read A1 range. `FORMULA` / `UNFORMATTED_VALUE` options.

No parameter schema in public metadata yet.

sheets_write_rangeoverwrite a range. `USER_ENTERED` parses formulas.

overwrite a range. `USER_ENTERED` parses formulas.

No parameter schema in public metadata yet.

sheets_appendappend rows below existing data

append rows below existing data

No parameter schema in public metadata yet.

sheets_clear_rangeclear values (formatting preserved)

clear values (formatting preserved)

No parameter schema in public metadata yet.

sheets_batch_readmulti-range read in one API call

multi-range read in one API call

No parameter schema in public metadata yet.

sheets_batch_writemulti-range write in one API call

multi-range write in one API call

No parameter schema in public metadata yet.

sheets_named_ranges_listlist named ranges in a workbook

list named ranges in a workbook

No parameter schema in public metadata yet.

sheets_named_range_addcreate a named range

create a named range

No parameter schema in public metadata yet.

sheets_named_range_deletedelete a named range

delete a named range

No parameter schema in public metadata yet.

sheets_conditional_format_addadd a conditional formatting rule

add a conditional formatting rule

No parameter schema in public metadata yet.

sheets_data_validation_addset dropdown / number / email / URL validation

set dropdown / number / email / URL validation

No parameter schema in public metadata yet.

Sponsors

Configuration

GOOGLE_OAUTH_CLIENT_ID*

From console.cloud.google.com

GOOGLE_OAUTH_CLIENT_SECRET*secret

From console.cloud.google.com

Readme

google-workspace-mcp


View the full README on GitHub

Details

Repository
github.com/adelaidasofia/google-workspace-mcp
Categories
Communication & Messaging, Data & Analytics, Productivity & Office
Package
https://github.com/adelaidasofia/google-workspace-mcp/releases/download/v0.1.0/google-workspace-mcp.mcpb
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from adelaidasofia

Related Communication & Messaging MCP servers

View all
1adelaidasofia avatarmacOS-only MCP server that exposes iMessage chatadelaidasofia/imessage-mcpmacOS-only MCP server that exposes iMessage chat.db to Claude and exports per-chat history to an…1stars
2getcoherence avatarMcpgetcoherence/mcp-serverCoherence MCP — chat with your CRM's AI agent from Claude, Cursor, and Cline.0stars
3mclose avatarDNS MCP Servermclose/dns-mcpReal-time DNS security analysis — DNSSEC, email auth, and RDAP. Built for SOC investigations.1stars
4shashwatgtm avatarImpact Mcpshashwatgtm/impact-mcpIMPACT: 8 B2B positioning and messaging tools by Helix GTM Consulting1stars
5synapbus avatarSynapbussynapbus/synapbusMCP-native agent-to-agent messaging hub with channels, DMs, and semantic search1stars
6adelaidasofia avatarFastMCP server that pages on-call via 100+ notification channels (Apprise wrappeadelaidasofia/paging-mcpFastMCP server that pages on-call via 100+ notification channels (Apprise wrapper)0stars