List all configured Gmail inbox accounts and their authentication/health status.

Read emails from one account or aggregate across all enabled accounts when account is omitted.

Search Gmail using query syntax. Omitting account searches all enabled inboxes and merges results.

Search Google Drive file metadata. Omitting account searches all enabled accounts and merges results.

Get a full email thread for one account (account required). Each message lists attachment metadata (filename, attachment_id, size). To read attachment content — PDF text, DOCX, XLSX, images via OCR — call get_all_attachments with the Gmail message ID shown as "Gmail ID" in each message.

List labels for one account (account required).

Mark messages as read in one account (account required).

Add labels to messages in one account (account required).

Remove labels from messages in one account (account required).

Archive messages in one account by removing INBOX label (account required).

Move messages to trash in one account (account required).

Create a new Gmail label in one account (account required).

Delete a Gmail label in one account (account required).

Block a sender by creating a Gmail filter (same mechanism as Gmail's native "Block" button). Optionally also trashes existing mail from that sender.

List all Gmail filters for an account. Use to find filter_id for unblock_sender, or to audit what is being auto-trashed/archived/spammed.

Remove a Gmail filter. Specify either filter_id (exact match) or sender (matches filters whose "from" criteria equals this value).

Unsubscribe from a mailing list by invoking the List-Unsubscribe header (RFC 2369/8058). Same mechanism as Gmail's native "Unsubscribe" button. Falls back to mailto:. Returns method used.

Mute a conversation: archives the thread now and (with scope="subject") installs a subject-based filter so future replies auto-archive. Approximates Gmail's client-side mute.

Create a draft email in one account (account required).

Permanently delete one or more drafts in one account (account required). Draft IDs are returned by create_draft or list_drafts.

Send an existing Gmail draft by draft ID. Returns message_id and thread_id. Use list_drafts to find draft IDs sorted oldest-first.

List drafts in an account sorted oldest-first by internalDate. Returns draft_id (for send_draft/delete_drafts), message_id, thread_id, subject, to, and internalDate.

Search drafts by Gmail query string. Returns draft_id (for send_draft/delete_drafts), message_id, thread_id, subject, to, and snippet. Use instead of search_emails when you need to delete or send a found draft.

Send an email from one account (account required).

Start OAuth onboarding for an account. Accepts credentials JSON or a path to credentials.json.

Complete OAuth onboarding by exchanging authorization code and storing token.json.

Fetch a single attachment by id. Use when you only need one specific file. For all attachments at once, use get_all_attachments instead. Requires the Gmail message ID ("Gmail ID" from get_email_thread) and the attachment_id. Saves to ~/Downloads/mcp-attachments/ and returns extracted text for PDF, DOCX, XLSX, PPTX, text, and images via OCR.

Call this whenever a thread or email shows attachments. Fetches and extracts content from all attachments in one shot: PDF (text extraction), DOCX, XLSX, PPTX, images (OCR). Use the Gmail message ID ("Gmail ID" from get_email_thread output) — NOT the thread ID. Saves each file to ~/Downloads/mcp-attachments/ and returns extracted text.

List Google Drive files. Omitting account aggregates across all enabled accounts. Optionally filter by folder or text query.

Get full metadata for a specific Google Drive file including size, parents, export links.

Download a Drive file and extract its text content. Google Docs/Sheets/Slides are exported to Office formats then parsed. PDFs, images, and text files are also supported.

Upload a local file to Google Drive.

Create a new folder in Google Drive.

Update a Drive file — rename it, move it between folders, star/unstar, or update its description.

Move a Google Drive file to trash.

Share a Google Drive file by adding a permission.

Get Google Sheets spreadsheet metadata: title, sheet tabs, row/column counts.

Read cell values from a Google Sheet range (e.g., "Sheet1!A1:D10" or "A1:D10" for the first sheet).

Write values to a Google Sheet range. Overwrites existing values in the specified range.

Append rows to a Google Sheet after the last row with data.

Create a new Google Sheets spreadsheet.

Add a new sheet tab to an existing spreadsheet.

Rename a sheet tab in a spreadsheet.

Delete a sheet tab from a spreadsheet.

Apply formatting to a range of cells: bold, italic, font size, background/text color, alignment, number format, wrap strategy.

Create a chart in a Google Sheet from a data range.

Insert rows or columns into a sheet at a specified position.

Delete rows or columns from a sheet.

Get the full text content and title of a Google Doc.

Create a new Google Doc.

Append text to the end of a Google Doc. Optionally apply a heading style and bold/italic.

Find and replace all occurrences of text throughout a Google Doc.

Insert an empty table at the end of a Google Doc.

Apply a heading or paragraph style to a text range in a Google Doc by character indices.

List all Google Calendars for one or all enabled accounts.

List calendar events. Omitting account aggregates across all enabled accounts. Supports time range and text search.

Get full details of a single calendar event.

Create a new calendar event. Use start_date_time/end_date_time for timed events or start_date/end_date for all-day events.

Update an existing calendar event. Only provided fields are changed.

Delete a calendar event.