Google Workspace MCP Server

NPM · GWS-MCP-SERVER · SCANNED AUG 3

Google Workspace as 39 curated MCP tools: Gmail, Calendar, Drive, Sheets, Docs, and Tasks.

Available components

+32 this week 78 78 Trust /100

Trust breakdown (6 categories)

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 →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency97

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 25 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability71

AI-judged instruction clarity (good).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 Management22

Stability check failed: the tool surface changed between 0.2.0 and 0.4.0: 2 tool removals, 0 breaking changes, 0 additions. See how to fix → Fail

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

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · gws-mcp-server

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add conorbronsdon-gws-mcp-server -- npx -y gws-mcp-server

# add to Codex CLI

codex mcp add conorbronsdon-gws-mcp-server -- npx -y gws-mcp-server

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "conorbronsdon-gws-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "gws-mcp-server"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add conorbronsdon-gws-mcp-server --command npx --arg -y --arg gws-mcp-server

# ~/.hermes/config.yaml

mcp_servers:
  conorbronsdon-gws-mcp-server:
    command: "npx"
    args: ["-y", "gws-mcp-server"]

// mcp.json

{
  "mcpServers": {
    "conorbronsdon-gws-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "gws-mcp-server"
      ]
    }
  }
}

Changelog

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.

3 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 18 to 22.
2 Aug 26 +56
- Stability: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Provenance: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- The attested source repository moved: conorbronsdon/gws-mcp-server security
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- Schema quality: unverified → good ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: MIT functional
- Package version: 0.2.0 → 0.4.0 functional
1 Aug 26 +16
- Tool coverage: unverified → 100 ▲ functional
31 Jul 26 −23
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
27 Jul 26 46

First indexed and scored.

Show 3 earlier entries Hide earlier entries

Diagnostics

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 3 Aug 2026 · Analysed npm/[email protected]

Provenance verified

Ecosystem: npm · Outcome: verified

Reason: verified

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
Discovery method:: attestation_endpoint

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 39 exposed · ~3,143 tokens

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.

Tool Tokens

calendar_events_delete ~36

Delete a calendar event.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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).

Input Output Examples

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).

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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).

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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).

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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. "[email protected], [email protected]"

No output schema declared.

No examples provided.

gmail_messages_get ~57

Get a single Gmail message by ID.

Input Output Examples

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.

Input Output Examples

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:[email protected] 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).

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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).

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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.

Input Output Examples

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".

Input Output Examples

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.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug