Google Workspace MCP — Gmail edition
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GWS_SERVICES | No | Services to load, e.g. `gmail`. Also what `authenticate` asks Google for. Unset loads every service the code supports. | |
| GWS_SAFETY_POLICY | No | Opt-in policies, comma-separated: `no-delete`, `audit`, `draft-only-email`, `read-only`. | |
| GWS_DEFAULT_ACCOUNT | No | Account a call acts as when `email` is omitted. Never used by `send_email`. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| manage_accountsA | Manage Google Workspace account lifecycle: list, authenticate, check status, refresh credentials, update scopes, or remove accounts. |
| manage_workspaceB | Manage files and directories in the workspace sandbox. Supports nested paths (e.g. "reports/q1/summary.csv"). The workspace is the exchange point for file operations (attachments, downloads, exports). |
| manage_scratchpadA | Compose, edit, and deliver text content. Use for any multi-line content: emails, documents, descriptions. Compose in the scratchpad, edit by line or JSON path, attach files, then send to any target. Mail goes out only as a Gmail draft from here; to actually send it, pass the final text to send_email. For short one-liners, use the service tool directly instead. |
| bulk_operationsA | Do many things in one call, two ways. mode:'queue' (default) runs different operations in sequence, chaining results with $N.field — works for every tool. mode:'batch' does ONE operation across many resources in a single Google request — far fewer round trips, but only where Google publishes a batch method. |
| queue_operationsA | RENAMED to |
| manage_calendarB | List events, view agenda, check availability, or manage calendar events. |
| manage_contactsB | Search, read, create, update and delete Google Contacts: your saved contacts, the addresses you have corresponded with but never saved, and your organization's directory. |
| manage_docsB | Read, write, insert, and find-replace text in Google Docs documents. |
| manage_driveC | Search, upload, download, share, comment on, or manage files in Google Drive. |
| send_emailA | Send mail from a Gmail account: a new message, a reply, a reply-all, or a forward. It sends immediately, so call it only for a message the user asked for, with the complete final text. |
| manage_emailA | Search, read, triage, label, archive, trash, report spam, and manage drafts, labels and filters in a Google Workspace account. Supports Gmail search syntax. This tool sends nothing: sending, replying and forwarding are send_email. |
| manage_meetB | Browse past Google Meet conferences, participants, transcripts, recordings, and AI-generated smart notes. Requires Workspace Business Standard+ for transcripts/recordings. |
| manage_sheetsC | Read, write, and manage Google Sheets spreadsheets. |
| manage_tasksC | Manage task lists and tasks in Google Tasks. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Active Safety Policies | Current safety policies controlling what operations are allowed, blocked, or audited |
| Available Services | Google Workspace services and operations available through this server |
| Workspace Directory | File I/O workspace directory status and path |
| Server Version | Build version of the google-workspace-mcp server |
TDQS
Scored across 14 tools
Most tools are clearly scoped to distinct Google services, but queue_operations is a deprecated duplicate of bulk_operations with identical functionality, creating confusion. Additionally, manage_scratchpad overlaps with manage_email's draft creation, leaving agents unsure which tool to use for composing drafts.
The set predominantly follows a consistent 'manage_<resource>' pattern (manage_email, manage_calendar, etc.). Minor deviations exist: send_email uses a different verb, and bulk_operations/queue_operations are noun phrases rather than verb_noun, but overall the naming is predictable.
With 14 tools, the count is well-suited for a broad Google Workspace suite, covering core services without being overwhelming. Each tool represents a distinct service or utility, and the count falls within the ideal 3–15 range.
The surface covers Gmail extensively (search, triage, labels, drafts, etc.) plus Calendar, Drive, Docs, Sheets, Contacts, Tasks, and Meet. Gaps include Google Slides, Forms, and Chat, but for a Gmail-centric edition, the core workflows are well-supported.