Google Workspace MCP Server
NPM · GWS-MCP-SERVER · SCANNED SEP 20
Google Workspace as 39 curated MCP tools: Gmail, Calendar, Drive, Sheets, Docs, and Tasks.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 31 of 96 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to conorbronsdon/gws-mcp-server). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 73 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability80
- AI-judged instruction clarity (excellent).Pass
- Tool/resource definitions use about 3143 tokens (~80/item across 39 items; 39 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management97
- Stability observed for 29 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 39 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the Google Workspace MCP Server server?
Google Workspace MCP Server runs locally as an npm package, launched with npx -y gws-mcp-server. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · gws-mcp-server
claude mcp add conorbronsdon-gws-mcp-server -- npx -y gws-mcp-server
{
"mcpServers": {
"conorbronsdon-gws-mcp-server": {
"command": "npx",
"args": [
"-y",
"gws-mcp-server"
]
}
}
} {
"servers": {
"conorbronsdon-gws-mcp-server": {
"command": "npx",
"args": [
"-y",
"gws-mcp-server"
]
}
}
} codex mcp add conorbronsdon-gws-mcp-server -- npx -y gws-mcp-server
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"conorbronsdon-gws-mcp-server": {
"type": "local",
"command": [
"npx",
"-y",
"gws-mcp-server"
],
"enabled": true
}
}
} openclaw mcp add conorbronsdon-gws-mcp-server --command npx --arg -y --arg gws-mcp-server
mcp_servers:
conorbronsdon-gws-mcp-server:
command: "npx"
args: ["-y", "gws-mcp-server"] {
"McpServers": {
"conorbronsdon-gws-mcp-server": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"gws-mcp-server"
]
}
}
} assistant mcp add conorbronsdon-gws-mcp-server -t stdio -c npx -a -y gws-mcp-server
{
"mcpServers": {
"conorbronsdon-gws-mcp-server": {
"command": "npx",
"args": [
"-y",
"gws-mcp-server"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 19 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 15 Sept 26 −3
- Stability: pass → 0.80 functional
- 14 Sept 26 +1
- Stability: 0.97 → pass security
- 12 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 10 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 8 Sept 26 −3
- Stability: pass → 0.80 functional
- 7 Sept 26 +1
- Stability: 0.97 → pass security
- Security disclosure: unverified → pass ▲ functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed npm/gws-mcp-server@0.4.0
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | conorbronsdon/gws-mcp-server |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/conorbronsdon/gws-mcp-server/.github/workflows/publish.yml@refs/heads/main |
| Rekor log index | 2113298157 |
| Predicate type | https://slsa.dev/provenance/v1 |
| Subject digest | sha512:22841cd3f7b16f1d0faa7cc14ecb9a83e80125041714de0ffe791be848bceaf0b35017cb0db40eeaccd00183bf90de478e87ba6845bb62a9fea853267 |
Background: How many MCP packages publish verified provenance →
Dependencies 96 packages
| Packages resolved | 96 |
|---|---|
| Stale | 31 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
calendar_events_delete ~36
Delete a calendar event.
| Name | Type | Req | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar ID |
| eventId | string | yes | Event ID to delete |
No output schema declared.
No examples provided.
calendar_events_get ~37
Get a single calendar event by ID.
| Name | Type | Req | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar ID |
| eventId | string | yes | Event ID |
No output schema declared.
No examples provided.
calendar_events_insert ~97
Create a new calendar event.
| Name | Type | Req | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar ID |
| description | string | – | Event description |
| end | string | yes | End time JSON |
| location | string | – | Event location |
| start | string | yes | Start time JSON (e.g. '{"dateTime":"2026-03-10T10:00:00-07:00"}') |
| summary | string | yes | Event title |
No output schema declared.
No examples provided.
calendar_events_list ~130
List events from a calendar.
| Name | Type | Req | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar ID (use 'primary' for main calendar) |
| maxResults | number | – | Max events to return |
| orderBy | string | – | Sort order: startTime or updated |
| q | string | – | Free-text search |
| singleEvents | boolean | – | Expand recurring events (usually true) |
| timeMax | string | – | Upper bound (RFC3339) |
| timeMin | string | – | Lower bound (RFC3339, e.g. "2026-03-07T00:00:00Z") |
No output schema declared.
No examples provided.
calendar_events_update ~83
Update an existing calendar event with patch semantics (only supplied fields change).
| Name | Type | Req | Description |
|---|---|---|---|
| calendarId | string | yes | Calendar ID |
| description | string | – | Event description |
| end | string | – | End time JSON |
| eventId | string | yes | Event ID to update |
| start | string | – | Start time JSON |
| summary | string | – | Event title |
No output schema declared.
No examples provided.
docs_batchUpdate ~48
Apply updates to a Google Doc (insert text, formatting, etc).
| Name | Type | Req | Description |
|---|---|---|---|
| documentId | string | yes | The document ID |
| requests | string | yes | Array of update requests as JSON string |
No output schema declared.
No examples provided.
docs_create ~24
Create a new empty Google Doc.
| Name | Type | Req | Description |
|---|---|---|---|
| title | string | yes | Document title |
No output schema declared.
No examples provided.
docs_get ~28
Get a Google Doc's content and metadata.
| Name | Type | Req | Description |
|---|---|---|---|
| documentId | string | yes | The document ID |
No output schema declared.
No examples provided.
drive_files_copy ~88
Copy a file. Useful for converting formats (e.g. markdown to Google Doc).
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | – | Fields to return |
| fileId | string | yes | Source file ID to copy |
| mimeType | string | – | Target MIME type for conversion |
| name | string | yes | Name for the copy |
| parents | string | – | Parent folder IDs (JSON array as string) |
No output schema declared.
No examples provided.
drive_files_create ~117
Create a new file in Google Drive. Use with bodyParams for metadata and optionally upload a local file.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | – | Fields to return (e.g. "id,webViewLink") |
| mimeType | string | – | MIME type (e.g. "application/vnd.google-apps.document") |
| name | string | yes | File name |
| parents | string | – | Parent folder IDs (JSON array as string, e.g. '["folderId"]') |
| uploadPath | string | – | Local file path to upload |
No output schema declared.
No examples provided.
drive_files_delete ~28
Permanently delete a file.
| Name | Type | Req | Description |
|---|---|---|---|
| fileId | string | yes | The file ID to delete |
No output schema declared.
No examples provided.
drive_files_download ~151
Download a file's content from Google Drive. Returns the text content for text files, or a base64-encoded string for binary files. For Google Docs/Sheets/Slides, exports to a readable format (plain text by default).
| Name | Type | Req | Description |
|---|---|---|---|
| exportMimeType | string | – | For Google-native files (Docs/Sheets/Slides): export format. Defaults to text/plain for Docs, text/csv for Sheets. Examples: text/plain, text/csv, application/pdf |
| fileId | string | yes | The file ID to download |
| savePath | string | – | For binary files (images, PDFs): save to this local path instead of returning content inline. The file path is returned in the response. |
No output schema declared.
No examples provided.
drive_files_export ~111
Export a Google Workspace file (Doc, Sheet, Slide) to a specific format. Returns JSON with export metadata. Use drive_files_download for automatic export with content returned inline.
| Name | Type | Req | Description |
|---|---|---|---|
| fileId | string | yes | The Google Workspace file ID to export |
| mimeType | string | yes | Export format: text/plain, text/csv, application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document (docx), application/vnd.openxmlformats-officedocument.spreadsheetml.sheet… |
No output schema declared.
No examples provided.
drive_files_get ~45
Get a file's metadata by ID. Shared drive files are supported automatically.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | – | Fields to include |
| fileId | string | yes | The file ID |
No output schema declared.
No examples provided.
drive_files_list ~122
List files in Google Drive. Supports search queries via the 'q' parameter. Shared drive files are included automatically.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | – | Fields to include (e.g. "files(id,name,mimeType)") |
| orderBy | string | – | Sort order (e.g. "modifiedTime desc") |
| pageSize | number | – | Max results per page (1-1000, default 100) |
| q | string | – | Search query (e.g. "name contains 'report'" or "mimeType='application/vnd.google-apps.folder'") |
No output schema declared.
No examples provided.
drive_files_update ~74
Update a file's metadata or content.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | – | Fields to return |
| fileId | string | yes | The file ID to update |
| mimeType | string | – | New MIME type |
| name | string | – | New file name |
| uploadPath | string | – | Local file path to upload |
No output schema declared.
No examples provided.
drive_permissions_create ~88
Share a file by creating a permission.
| Name | Type | Req | Description |
|---|---|---|---|
| emailAddress | string | – | Email of user/group (required for user/group type) |
| fileId | string | yes | The file ID to share |
| role | string | yes | Permission role: owner, organizer, fileOrganizer, writer, commenter, reader |
| type | string | yes | Grantee type: user, group, domain, anyone |
No output schema declared.
No examples provided.
gmail_drafts_create ~249
Create a Gmail draft. Pass threadId to attach the draft to an existing conversation (it will appear as a reply within that thread). The draft is NOT sent — open Gmail to review and send.
| Name | Type | Req | Description |
|---|---|---|---|
| bcc | string | – | BCC recipient(s), comma-separated |
| body | string | – | Plain-text body |
| cc | string | – | CC recipient(s), comma-separated |
| htmlBody | string | – | HTML body. If both body and htmlBody are provided, the draft is multipart/alternative. |
| inReplyTo | string | – | Message-ID header value of the message being replied to. Improves threading robustness alongside threadId. |
| references | string | – | References header value (space-separated Message-IDs of ancestor messages). |
| subject | string | – | Subject line. When attaching to a thread via threadId, Gmail expects the subject to match the thread (typically "Re: <original>"). |
| threadId | string | – | Thread ID to attach this draft to. Get it from gmail_threads_list / gmail_messages_get. |
| to | string | yes | Recipient(s). Comma-separated for multiple, e.g. "a@x.com, b@y.com" |
No output schema declared.
No examples provided.
gmail_messages_get ~57
Get a single Gmail message by ID.
| Name | Type | Req | Description |
|---|---|---|---|
| format | string | – | Response format: full, metadata, minimal, raw |
| id | string | yes | Message ID |
| userId | string | yes | User ID (use 'me') |
No output schema declared.
No examples provided.
gmail_messages_list ~77
List Gmail messages matching a query.
| Name | Type | Req | Description |
|---|---|---|---|
| labelIds | string | – | Label IDs to filter by |
| maxResults | number | – | Max messages to return |
| q | string | – | Gmail search query (e.g. "from:user@example.com subject:hello") |
| userId | string | yes | User ID (use 'me') |
No output schema declared.
No examples provided.
gmail_threads_get ~61
Get a full Gmail thread by ID (all messages in the conversation).
| Name | Type | Req | Description |
|---|---|---|---|
| format | string | – | Response format: full, metadata, minimal |
| id | string | yes | Thread ID |
| userId | string | yes | User ID (use 'me') |
No output schema declared.
No examples provided.
gmail_threads_list ~52
List Gmail threads matching a query.
| Name | Type | Req | Description |
|---|---|---|---|
| maxResults | number | – | Max threads to return |
| q | string | – | Gmail search query |
| userId | string | yes | User ID (use 'me') |
No output schema declared.
No examples provided.
gmail_threads_modify ~112
Modify a Gmail thread: add/remove labels. To archive, remove INBOX. To mark read, remove UNREAD. To star, add STARRED.
| Name | Type | Req | Description |
|---|---|---|---|
| addLabelIds | string | – | JSON array of label IDs to add, e.g. ["STARRED"] |
| id | string | yes | Thread ID |
| removeLabelIds | string | – | JSON array of label IDs to remove, e.g. ["INBOX","UNREAD"] |
| userId | string | yes | User ID (use 'me') |
No output schema declared.
No examples provided.
sheets_get ~35
Get spreadsheet metadata.
| Name | Type | Req | Description |
|---|---|---|---|
| includeGridData | boolean | – | Include grid data |
| spreadsheetId | string | yes | The spreadsheet ID |
No output schema declared.
No examples provided.
sheets_values_append ~75
Append values after the last row of a spreadsheet range.
| Name | Type | Req | Description |
|---|---|---|---|
| range | string | yes | A1 notation range to append to |
| spreadsheetId | string | yes | The spreadsheet ID |
| valueInputOption | string | yes | RAW or USER_ENTERED |
| values | string | yes | 2D array of values as JSON string |
No output schema declared.
No examples provided.
sheets_values_get ~86
Read values from a spreadsheet range.
| Name | Type | Req | Description |
|---|---|---|---|
| majorDimension | string | – | ROWS or COLUMNS |
| range | string | yes | A1 notation range (e.g. "Sheet1!A1:D10") |
| spreadsheetId | string | yes | The spreadsheet ID |
| valueRenderOption | string | – | FORMATTED_VALUE, UNFORMATTED_VALUE, or FORMULA |
No output schema declared.
No examples provided.
sheets_values_update ~85
Write values to a spreadsheet range.
| Name | Type | Req | Description |
|---|---|---|---|
| range | string | yes | A1 notation range to write |
| spreadsheetId | string | yes | The spreadsheet ID |
| valueInputOption | string | yes | RAW or USER_ENTERED |
| values | string | yes | 2D array of values as JSON string (e.g. '[["A","B"],["C","D"]]') |
No output schema declared.
No examples provided.
tasks_tasklists_delete ~47
Delete a task list. If it contains assigned tasks, the originals (in Docs/Chat Spaces) are also removed.
| Name | Type | Req | Description |
|---|---|---|---|
| tasklist | string | yes | Task list ID to delete |
No output schema declared.
No examples provided.
tasks_tasklists_get ~38
Get a task list by ID.
| Name | Type | Req | Description |
|---|---|---|---|
| tasklist | string | yes | Task list ID (use "@default" for the user's default list) |
No output schema declared.
No examples provided.
tasks_tasklists_insert ~26
Create a new task list.
| Name | Type | Req | Description |
|---|---|---|---|
| title | string | yes | Task list title |
No output schema declared.
No examples provided.
tasks_tasklists_list ~53
List the authenticated user's task lists.
| Name | Type | Req | Description |
|---|---|---|---|
| maxResults | number | – | Max task lists per page (1-100, default 20) |
| pageToken | string | – | Token for the next page of results |
No output schema declared.
No examples provided.
tasks_tasklists_update ~44
Update a task list (only supplied fields change).
| Name | Type | Req | Description |
|---|---|---|---|
| tasklist | string | yes | Task list ID to update |
| title | string | – | New task list title |
No output schema declared.
No examples provided.
tasks_tasks_clear ~44
Hide all completed tasks in a list. Cleared tasks are not deleted but stop appearing in default list responses.
| Name | Type | Req | Description |
|---|---|---|---|
| tasklist | string | yes | Task list ID to clear |
No output schema declared.
No examples provided.
tasks_tasks_delete ~49
Delete a task. If assigned from Docs/Chat Spaces, the original is also removed.
| Name | Type | Req | Description |
|---|---|---|---|
| task | string | yes | Task ID to delete |
| tasklist | string | yes | Task list ID |
No output schema declared.
No examples provided.
tasks_tasks_get ~35
Get a task by ID.
| Name | Type | Req | Description |
|---|---|---|---|
| task | string | yes | Task ID |
| tasklist | string | yes | Task list ID |
No output schema declared.
No examples provided.
tasks_tasks_insert ~149
Create a new task. Use parent to nest as a subtask, previous to position after a sibling.
| Name | Type | Req | Description |
|---|---|---|---|
| due | string | – | Due date (RFC 3339, e.g. "2026-06-01T00:00:00.000Z") |
| notes | string | – | Free-text notes / body |
| parent | string | – | Parent task ID (insert as a subtask under this task) |
| previous | string | – | Sibling task ID (insert immediately after this task) |
| status | string | – | Task status: needsAction or completed |
| tasklist | string | yes | Task list ID to insert into |
| title | string | yes | Task title |
No output schema declared.
No examples provided.
tasks_tasks_list ~245
List tasks in a task list. Excludes hidden and assigned tasks by default; set showHidden/showAssigned to include them.
| Name | Type | Req | Description |
|---|---|---|---|
| completedMax | string | – | Upper bound on completion date (RFC 3339) |
| completedMin | string | – | Lower bound on completion date (RFC 3339) |
| dueMax | string | – | Upper bound on due date (RFC 3339) |
| dueMin | string | – | Lower bound on due date (RFC 3339) |
| maxResults | number | – | Max tasks per page (1-100, default 20) |
| pageToken | string | – | Token for the next page of results |
| showAssigned | boolean | – | Include tasks assigned from Docs/Chat Spaces |
| showCompleted | boolean | – | Include completed tasks (default true; ignored unless showHidden is also true) |
| showDeleted | boolean | – | Include deleted tasks |
| showHidden | boolean | – | Include hidden (cleared) tasks |
| tasklist | string | yes | Task list ID (use "@default" for the default list) |
| updatedMin | string | – | Lower bound on last-modified time (RFC 3339) |
No output schema declared.
No examples provided.
tasks_tasks_move ~115
Move a task within its list or to another list. Use parent/previous to set position; destinationTasklist to change list.
| Name | Type | Req | Description |
|---|---|---|---|
| destinationTasklist | string | – | Destination task list ID (omit to move within the source list) |
| parent | string | – | New parent task ID (move as subtask under this task) |
| previous | string | – | New sibling task ID (move immediately after this task) |
| task | string | yes | Task ID to move |
| tasklist | string | yes | Source task list ID |
No output schema declared.
No examples provided.
tasks_tasks_update ~102
Update a task (only supplied fields change). Common use: complete a task by setting status to "completed".
| Name | Type | Req | Description |
|---|---|---|---|
| due | string | – | Due date (RFC 3339) |
| notes | string | – | Free-text notes / body |
| status | string | – | Task status: needsAction or completed |
| task | string | yes | Task ID to update |
| tasklist | string | yes | Task list ID |
| title | string | – | Task title |
No output schema declared.
No examples provided.
What is the Google Workspace MCP Server server?
Google Workspace MCP Server is listed in the public MCP registry as io.github.conorbronsdon/gws-mcp-server. Google Workspace as 39 curated MCP tools: Gmail, Calendar, Drive, Sheets, Docs, and Tasks. This page covers its npm package (gws-mcp-server).
Is the Google Workspace MCP Server server safe to use?
Google Workspace MCP Server scores 95 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Google Workspace MCP Server server expose?
Google Workspace MCP Server exposes 39 tools: drive_files_list, drive_files_get, drive_files_create, drive_files_copy, drive_files_update, and 34 more. Their descriptions and schemas cost roughly 3,143 tokens of context every time the server is loaded.
Is the Google Workspace MCP Server server still maintained?
Google Workspace MCP Server is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Google Workspace MCP Server server under?
Google Workspace MCP Server declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.