mcp-google-workspace
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_HOST | No | Host for SSE server | 127.0.0.1 |
| MCP_PORT | No | Port for SSE server | 8000 |
| ENABLE_CHAT | No | Enable Google Chat integration (disabled by default, typically requires Google Workspace account) | false |
| ENABLE_KEEP | No | Enable Google Keep integration (disabled by default due to OAuth scope restrictions) | false |
| ENABLE_MEET | No | Enable Google Meet integration (disabled by default, requires Meet API enabled) | false |
| ENABLE_GEMINI | No | Enable Gemini media tools (requires GEMINI_API_KEY) | false |
| GEMINI_API_KEY | No | API key for Gemini media tools (required if ENABLE_GEMINI is true) | |
| ENABLE_APPS_DASHBOARD | No | Enable the MCP Apps dashboard UI namespace (opt-in for controlled rollout) | false |
| GEMINI_REASONING_MODEL | No | Model for Gemini reasoning | gemini-3.1-pro-preview |
| GEMINI_IMAGE_EDIT_MODEL | No | Model for Gemini image editing | gemini-3.1-flash-image-preview |
| GEMINI_IMAGE_GENERATE_MODEL | No | Model for Gemini image generation | gemini-3.1-flash-image-preview |
| GEMINI_AUDIO_UNDERSTANDING_MODEL | No | Model for Gemini audio understanding | gemini-3-flash-preview |
| GEMINI_VIDEO_UNDERSTANDING_MODEL | No | Model for Gemini video understanding | gemini-3-flash-preview |
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 |
|---|---|
| tasks | {
"list": {},
"cancel": {},
"requests": {
"tools": {
"call": {}
},
"prompts": {
"get": {}
},
"resources": {
"read": {}
}
}
} |
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| connect_google_workspaceA | Connect locally with loopback OAuth or return a remote incremental-consent URL. |
| get_google_connection_statusB | Report whether the authenticated MCP user has connected Google Workspace. |
| disconnect_google_workspaceB | Remove only the authenticated user's encrypted Google OAuth credentials. |
| refresh_workspace_catalogA | Refresh capability-aware tools after Google consent or disconnection. |
| get_mcp_apps_diagnosticsA | Describe the file-picker MCP Apps contract and optionally verify callbacks. |
| get_workspace_capabilitiesA | Describe available namespaces, consent capabilities, and file-transfer choices. |
| search_workspaceB | Search Drive files, contacts, and Gmail IDs through one normalized entry point. |
| resolve_workspace_resourceA | Resolve a stable Workspace URI to fresh compact metadata. |
| prepare_workspace_actionA | Preview and bind one consequential action to a short-lived one-time commit token. |
| commit_workspace_actionA | Atomically consume a prepared action token and execute its exact bound arguments. |
| files_list_filesA | List all uploaded files with metadata. |
| files_file_managerC | Upload and manage files. Drop files here to send them to the server. |
| files_list_files_pageA | Page through uploaded files without returning an unbounded catalog. |
| search_toolsA | Search for tools using natural language. Returns matching tool definitions ranked by relevance, in the same format as list_tools. |
| call_toolA | Call a tool by name with the given arguments. Use this to execute tools discovered via search_tools. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| gmail_compose_email_prompt | |
| gmail_reply_email_prompt | |
| gmail_summarize_inbox_prompt |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| inbox_summary | |
| gmail_labels | |
| calendar_today | |
| calendar_week | |
| drive_recent_files | |
| drive_shared_drives | |
| Prefab Renderer (file_manager) |
TDQS
Scored across 15 tools
Most tools have distinct purposes, but the file tools overlap: files_list_files and files_list_files_page both list files, and files_file_manager is a catch-all that could confuse selection. The meta-tools call_tool and search_tools also add ambiguity about when to use direct vs meta tools.
Naming is mostly verb_noun with underscores, but there are inconsistencies: some tools use google_workspace, others just workspace, and the files_ prefix is applied inconsistently (files_file_manager is a noun phrase, not a verb). The files_list_files_page variant deviates from the simple verb_noun pattern.
15 tools is within the expected range, but the set includes redundant file listing tools and generic meta-tools (call_tool, search_tools) that could be considered unnecessary. Still, the count is reasonable for the scope.
The tool surface lacks common Google Workspace operations like sending email, creating events, or reading contacts beyond search. It focuses on connection management, search, and a generic action mechanism, leaving significant gaps for an agent trying to perform typical Workspace tasks.