Multi-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, token

Reject ALL pending suggestions by rewriting the Doc. DESTRUCTIVE — rewrites the entire document body; suggestions are permanently discarded. No per-suggestion reject via API. Call docs_suggestions_list first to review what will be discarded.

Add a sidebar comment (annotation) to a Drive file — not text to the document body. Works on Docs, Sheets, Slides, PDFs, etc. To add text to a Doc's body, use docs_append or docs_insert_at.

Reply to an existing comment.

Mark a comment as resolved.

List comments on any Drive file (Doc/Sheet/Slide/uploaded).

Create a new folder. If parent_id is None, creates at My Drive root.

List direct children of a folder. Use 'root' for My Drive root.

Move a file to a different folder.

Revoke a permission on a file. DESTRUCTIVE — removes someone's access immediately. Get permission_id from drive_permission_list first.

List all permissions (who has access) on a file.

Change the access role of someone who already has a permission on this file. Requires a permission_id — get it first from drive_permission_list. To grant access to someone new, use drive_share instead. Args: role: 'reader' | 'commenter' | 'writer' | 'fileOrganizer' | 'organizer' | 'owner'.

Read a Drive file. Metadata by default; content is opt-in. Args: include_content: If True, fetch content. Google-native files export to text/csv/plain by default; override with export_mime. For Google Docs where you want markdown or docx output, use docs_export instead. export_mime: e.g. 'text/markdown' (Docs), 'application/pdf', or 'text/csv' (Sheets). Ignored for non-Google files. max_chars: Cap on returned content. Default 50k.

Rename a file or folder.

Search Drive files. Returns compact metadata (no content). Args: query: Free text (wrapped as name/fullText contains) OR raw Drive q-syntax if it contains '=' or 'contains' (e.g. "mimeType='application/pdf' and modifiedTime > '2026-04-01T00:00:00'"). limit: 1-100. Default 10. order_by: 'modifiedTime desc' | 'name' | 'createdTime desc' | etc. drive_id: Shared drive ID. Default: My Drive + shared-with-me.

Grant access to a file for someone who does not yet have a permission entry. Creates a new permission. Requires their email address. To change the role of someone who already has access, use drive_permission_update instead. Args: role: 'reader' | 'commenter' | 'writer' | 'fileOrganizer' | 'organizer' | 'owner'. send_notification: If True, Google emails the grantee about the share.

List shared drives this account can access.

Move a file to Trash (soft delete, recoverable for 30 days). DESTRUCTIVE. Args: dry_run: If True, show what would be trashed without actually trashing it.

Restore a file from Trash.

Upload a local file to Drive. Args: convert_to_google: If True, .docx/.csv/.xlsx/.pptx etc. convert to Google-native formats (Docs/Sheets/Slides) on upload.

Archive messages: removes INBOX label but keeps them in All Mail, permanently searchable. No deletion. Use this to declutter without destroying. Use gmail_trash for soft-delete (messages auto-purged after 30 days).

Download one attachment to a local file and return its path, so the caller can read it directly (PDF, image, docx, ...). Call gmail_attachments_list first for attachment_id and filename. Saves under ~/.claude/google-workspace-mcp/downloads unless dest_dir is given.

List a message's attachments: filename, mime type, size, and the attachment_id gmail_attachment_save needs. Metadata only, no download.

Create a draft. Does not send. Args: body: Plain text or HTML. A body that opens with an HTML tag (e.g. "<p>") becomes an HTML email with a plain-text fallback; any other body stays plain text.

Add or remove labels on messages. Batch up to 1000 per call.

List all labels on the account.

Read a single message or full thread. Strips HTML to text by default. Args: message_id: Gmail message id from gmail_search. keep_html: If True, return raw HTML body. Default: strip to plain text. full_thread: If True, return all messages in the thread.

Reply to a message. DESTRUCTIVE — sends immediately, same blast radius as gmail_send. Preserves thread + headers. Args: body: Plain text or HTML. A body that opens with an HTML tag (e.g. "<p>") becomes an HTML email with a plain-text fallback; any other body stays plain text. dry_run: If True, show what WOULD be sent without sending.

Search Gmail messages. Returns compact shape (no body) — call gmail_read for body. Args: query: Gmail search operators, e.g. 'from:someone@example.com after:2026/04/01 is:unread'. account: Email address; defaults to configured default account. limit: 1-50. Default 10. include_spam_trash: Include SPAM/TRASH in results. label_filter: List of label names to filter by (e.g. ['INBOX', 'starred']).

Send an email. DESTRUCTIVE — irreversible once sent. Args: body: Plain text or HTML. A body that opens with an HTML tag (e.g. "<p>") becomes an HTML email with a plain-text fallback; any other body stays plain text. from_alias: Send-as identity (e.g. 'ops@example.com'). The authenticated `account` must have this alias configured in Gmail. Use gmail_sendas_list to see available aliases. dry_run: If True, return what WOULD be sent without calling the API. Use this to verify recipient, subject, and body before committing.

List Send-As identities for this account (the aliases it can send as).

Move messages to Trash. Soft delete: auto-purged after 30 days, not easily searchable. Use gmail_archive to remove from inbox without any deletion risk.

Authorize a new Google account via browser OAuth. Stores the refresh token in the OS keyring (service: google-workspace-mcp) -- Keychain on macOS, Credential Manager on Windows, Secret Service on Linux. Requires the OAuth client: GWS_CLIENT_ID + GWS_CLIENT_SECRET in the environment, or client_secret.json next to server.py. See SETUP.md.

List all authorized Google accounts and which one is the default.

Revoke local storage for an account. (Does not revoke Google-side; do that at https://myaccount.google.com/permissions.)

Add a new tab (sheet) to an existing workbook.

Append rows below the existing data in a range or sheet. Args: range_a1: Table range or sheet name (e.g. 'Sheet1!A:D' or 'Sheet1'). insert_data: 'INSERT_ROWS' (shifts down) | 'OVERWRITE'.

Read multiple ranges in one API call. Cheaper than N sheets_read_range.

Write multiple ranges in one API call. Args: updates: List of {range: 'Sheet1!A1:B2', values: [[...], [...]]}.

Clear cell values in a range. Leaves formatting intact.

Add a conditional formatting rule. Args: condition_type: 'NUMBER_GREATER' | 'NUMBER_LESS' | 'TEXT_CONTAINS' | 'TEXT_EQ' | 'DATE_AFTER' | 'CUSTOM_FORMULA' | 'BLANK' | 'NOT_BLANK'. condition_values: Values for the condition (e.g. ['100'] or ['=A1>B1']). bg_color / text_color: {'red': 0-1, 'green': 0-1, 'blue': 0-1}.

Create a new Google Sheets workbook.

Set data validation on a range. Args: condition_type: 'ONE_OF_LIST' (dropdown) | 'NUMBER_GREATER' | 'NUMBER_BETWEEN' | 'DATE_IS_VALID' | 'TEXT_IS_EMAIL' | 'TEXT_IS_URL' | 'CUSTOM_FORMULA'. condition_values: e.g. ['yes','no','maybe'] for ONE_OF_LIST. strict: If True, reject invalid input; if False, warn only.

List all tabs in a workbook with their dimensions.

Create a named range (zero-based indices, end-exclusive). Get sheet_id from sheets_list_sheets.

Delete a named range by id.

List all named ranges in a workbook.

Read a range of cells. Returns 2D array of values. Args: range_a1: A1 notation — 'Sheet1!A1:D100' or 'Sheet1' for full tab. value_render: 'FORMATTED_VALUE' | 'UNFORMATTED_VALUE' | 'FORMULA'.

Write a 2D array of values to a range. Overwrites existing cells. Args: value_input: 'USER_ENTERED' (parses formulas + dates) | 'RAW' (literal).