DOCS BLOG ABOUT TRY THE GATEWAY

// MCP TOOL REFERENCE

GOOGLE WORKSPACE GMAIL (GWS CLI) TOOLS

79 tools from the Google Workspace Gmail (gws CLI) MCP Server, categorised by risk level.

View the Google Workspace Gmail (gws CLI) policy →

// ALL 79 GOOGLE WORKSPACE GMAIL (GWS CLI) TOOLS

READ 30 tools

Read gmail_users_drafts_get Get an email draft by ID Read gmail_users_drafts_list List all drafts in the mailbox Read gmail_users_getProfile Get the current user's Gmail profile Read gmail_users_history_list List history of mailbox changes Read gmail_users_labels_get Get a label by ID Read gmail_users_labels_list List all labels in the mailbox Read gmail_users_messages_attachments_get Download a message attachment Read gmail_users_messages_get Get an email message by ID Read gmail_users_messages_list List messages in the mailbox Read gmail_users_settings_cse_identities_get Get a client-side encryption identity Read gmail_users_settings_cse_identities_list List client-side encryption identities Read gmail_users_settings_cse_keypairs_get Get a client-side encryption keypair Read gmail_users_settings_cse_keypairs_list List client-side encryption keypairs Read gmail_users_settings_delegates_get Get a mailbox delegate Read gmail_users_settings_delegates_list List mailbox delegates Read gmail_users_settings_filters_get Get a message filter by ID Read gmail_users_settings_filters_list List all message filters Read gmail_users_settings_forwardingAddresses_get Get a forwarding address Read gmail_users_settings_forwardingAddresses_list List forwarding addresses Read gmail_users_settings_getAutoForwarding Get auto-forwarding settings Read gmail_users_settings_getImap Get IMAP settings Read gmail_users_settings_getLanguage Get language settings Read gmail_users_settings_getPop Get POP settings Read gmail_users_settings_getVacation Get vacation responder settings Read gmail_users_settings_sendAs_get Get a send-as alias Read gmail_users_settings_sendAs_list List send-as aliases Read gmail_users_settings_sendAs_smimeInfo_get Get an S/MIME configuration Read gmail_users_settings_sendAs_smimeInfo_list List S/MIME configs for a send-as alias Read gmail_users_threads_get Get an email thread by ID Read gmail_users_threads_list List email threads in the mailbox

WRITE 36 tools

Write gmail_users_drafts_create Create a new email draft Write gmail_users_drafts_send Send an existing draft to its recipients Write gmail_users_drafts_update Replace an existing draft's content Write gmail_users_labels_create Create a new mailbox label Write gmail_users_labels_patch Patch a mailbox label Write gmail_users_labels_update Update a mailbox label Write gmail_users_messages_batchModify Batch modify labels on multiple messages Write gmail_users_messages_import Import a message via SMTP-like delivery Write gmail_users_messages_insert Insert a message bypassing spam scanning Write gmail_users_messages_modify Modify labels on a message Write gmail_users_messages_send Send a new email to recipients Write gmail_users_messages_trash Move a message to the trash Write gmail_users_messages_untrash Restore a message from the trash Write gmail_users_settings_cse_identities_create Create a client-side encryption identity Write gmail_users_settings_cse_identities_patch Patch a CSE identity Write gmail_users_settings_cse_keypairs_create Create and upload a CSE keypair Write gmail_users_settings_cse_keypairs_disable Disable a CSE keypair Write gmail_users_settings_cse_keypairs_enable Enable a disabled CSE keypair Write gmail_users_settings_delegates_create Add a mailbox delegate with access Write gmail_users_settings_filters_create Create a message filter rule Write gmail_users_settings_forwardingAddresses_create Create a forwarding address Write gmail_users_settings_sendAs_create Create a custom send-as alias Write gmail_users_settings_sendAs_patch Patch a send-as alias Write gmail_users_settings_sendAs_smimeInfo_insert Upload an S/MIME config for a send-as alias Write gmail_users_settings_sendAs_smimeInfo_setDefault Set the default S/MIME config for an alias Write gmail_users_settings_sendAs_update Update a send-as alias Write gmail_users_settings_sendAs_verify Send verification email for a send-as alias Write gmail_users_settings_updateAutoForwarding Update auto-forwarding settings Write gmail_users_settings_updateImap Update IMAP settings Write gmail_users_settings_updateLanguage Update language settings Write gmail_users_settings_updatePop Update POP settings Write gmail_users_settings_updateVacation Update vacation responder settings Write gmail_users_threads_modify Modify labels on an email thread Write gmail_users_threads_trash Move an email thread to the trash Write gmail_users_threads_untrash Restore an email thread from the trash Write gmail_users_watch Set up push notification watch on mailbox

DESTRUCTIVE 12 tools

Destructive gmail_users_drafts_delete Permanently delete a draft Destructive gmail_users_labels_delete Permanently delete a label from all messages Destructive gmail_users_messages_batchDelete Permanently batch delete messages by ID Destructive gmail_users_messages_delete Permanently delete a message Destructive gmail_users_settings_cse_identities_delete Permanently delete a CSE identity Destructive gmail_users_settings_cse_keypairs_obliterate Permanently destroy a CSE keypair Destructive gmail_users_settings_delegates_delete Remove a mailbox delegate and revoke access Destructive gmail_users_settings_filters_delete Permanently delete a message filter Destructive gmail_users_settings_forwardingAddresses_delete Delete a forwarding address Destructive gmail_users_settings_sendAs_delete Delete a send-as alias Destructive gmail_users_settings_sendAs_smimeInfo_delete Delete an S/MIME config for a send-as alias Destructive gmail_users_threads_delete Permanently delete a thread and all messages

EXECUTE 1 tools

Execute gmail_users_stop Stop push notifications for the mailbox

// RUNNING THIS SERVER

The managed route: connect Google Workspace Gmail (gws CLI) through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y @gws mcp -s gmail

// FAQ

How many tools does the Google Workspace Gmail (gws CLI) MCP server have? +

The Google Workspace Gmail (gws CLI) MCP server exposes 79 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Google Workspace Gmail (gws CLI) tools? +

Route the Google Workspace Gmail (gws CLI) server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Google Workspace Gmail (gws CLI) tools fall into? +

Google Workspace Gmail (gws CLI) tools are categorised as Read (30), Write (36), Destructive (12), Execute (1). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.