Skip to main content
Glama
rajool

google-workspace-mcp

by rajool

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GWM_HOMENoOverride config home directory. Defaults to $XDG_CONFIG_HOME/google-workspace-mcp or ~/.config/google-workspace-mcp
GWM_ACCOUNTSNoComma-separated list of account slugs or inline JSON map to expose. Omit to expose all accounts from registry.
GWM_TOKENS_DIRNoOverride directory for per-account token files.
GWM_CREDENTIALSNoOverride path to OAuth client credentials JSON file.
GWM_ACCOUNTS_FILENoOverride path to account registry JSON file.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
accounts_listA

List the configured Google accounts and whether each has a valid token.

gmail_sendA

Send an email immediately from the given account.

For replies, pass thread_id AND in_reply_to_message_id (the RFC822
Message-Id header value, NOT the Gmail message id) so the reply
threads correctly.
gmail_draft_createC

Create a Gmail draft. Returns {id, message: {...}}.

gmail_draft_updateC

Overwrite an existing draft's contents.

gmail_draft_sendC

Send an existing draft.

gmail_draft_deleteC

Permanently delete a draft (the thing the default connector can't do).

gmail_drafts_listC

List drafts. query uses standard Gmail search syntax.

gmail_searchB

Search messages with Gmail's query syntax (e.g. 'from:foo subject:bar').

gmail_message_getC

Fetch one message. format=full includes the body.

gmail_message_trashB

Move a message to Trash (reversible for 30 days).

gmail_message_modifyC

Add/remove labels on a message (e.g. mark read by removing UNREAD).

gmail_labels_listC

List all labels for the account.

gmail_thread_getC

Fetch a whole thread (all messages).

calendar_listC

List all calendars the account can access.

calendar_events_listC

List events. time_min/time_max are RFC3339 (e.g. '2026-06-05T00:00:00-07:00').

calendar_event_getC

Fetch one event.

calendar_event_createB

Create an event. start/end are RFC3339 datetimes; date-only ('2026-06-10') makes an all-day event.

calendar_event_updateB

Patch an existing event — only the fields you pass are changed.

calendar_event_deleteC

Delete an event.

drive_searchB

List/search files. query uses Drive query language; see https://developers.google.com/drive/api/guides/search-files Examples: "name contains 'budget'" "mimeType='application/vnd.google-apps.folder'" "'' in parents"

drive_file_getC

Get a file's full metadata.

drive_file_downloadB

Download a file. For Google Docs/Sheets/Slides, pass export_mime_type (e.g. 'application/pdf', 'text/plain', 'text/csv').

drive_file_uploadB

Upload a local file to Drive. convert_to_google_doc=True converts .docx/.xlsx/.pptx to native Google Docs/Sheets/Slides.

drive_file_moveC

Move a file to a new folder.

drive_file_renameD

Rename a file.

drive_file_trashC

Move a file to trash (reversible).

drive_folder_createC

Create a new folder.

drive_file_shareC

Share a file with someone by email.

tasklist_listA

List the account's task lists (each has an id + title).

tasklist_createC

Create a new task list.

tasklist_deleteB

Delete a task list and all its tasks. Irreversible.

task_listB

List tasks in a list. Find ids via tasklist_list; '@default' is the account's default list.

task_getC

Fetch a single task.

task_createA

Create a task. due is RFC3339 (e.g. '2026-06-15T00:00:00Z') — Google Tasks keeps only the DATE part. parent makes it a subtask of that task id; previous orders it after that task id.

task_updateA

Patch a task's fields. status='completed' completes it (or use task_complete).

task_completeB

Mark a task completed (shortcut for status='completed').

task_deleteC

Delete a task. Irreversible.

task_moveB

Reposition a task: under parent (as a subtask) and/or after previous in the same list.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rajool/google-workspace-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server