Gmail

Manage your Gmail inbox � send and read emails, organize with labels, manage drafts and threads, handle attachments, and configure vacation auto-reply through…

CommunityOnlineAPI key requiredGlobalFreeCan modify data

What it can do

  • Gmail List Messages: List messages in the mailbox. Supports Gmail search syntax for filtering (e.g., from:, to:, subject:, is:unread, has:attachment).
  • Gmail Get Message: Get a specific message by ID. Returns headers, body, labels, and metadata. Use format=full for parsed body or format=raw for RFC 2822.
  • Gmail Send Message: Send an email message. Supports plain text and HTML body, CC, BCC, and replying to threads.

What data it sees

Do you need an account

An API key from the service settings is required

Manage your Gmail inbox � send and read emails, organize with labels, manage drafts and threads, handle attachments, and configure vacation auto-reply through 28 MCP tools.

Features

  • Send, read, and search emails with Gmail search syntax
  • Manage drafts (create, update, send)
  • Organize with labels (create, update, apply to messages)
  • Thread-based conversation management
  • Batch operations for bulk label changes and deletions
  • Attachment retrieval
  • Vacation auto-reply settings
  • Full OAuth 2.0 authentication with refresh tokens

28 Tools

Messages (10): List, get, send, delete, trash, untrash, modify labels, batch delete, batch modify, get attachment

Drafts (6): List, get, create, update, delete, send

Labels (5): List, get, create, update, delete

Threads (5): List, get, modify labels, trash, untrash

Settings (2): Get profile, update vacation auto-reply

Configuration

  • GOOGLE_CLIENT_ID � OAuth 2.0 Client ID from Google Cloud Console
  • GOOGLE_CLIENT_SECRET � OAuth 2.0 Client Secret
  • GOOGLE_REFRESH_TOKEN � Refresh token with Gmail scope
Server tool list (28)

Raw names from tools/list. Only developers need these.

gmail_list_messagesList messages in the mailbox. Supports Gmail search syntax for filtering (e.g., from:, to:, subject:, is:unread, has:attachment).
gmail_get_messageGet a specific message by ID. Returns headers, body, labels, and metadata. Use format=full for parsed body or format=raw for RFC 2822.
gmail_send_messageSend an email message. Supports plain text and HTML body, CC, BCC, and replying to threads.
gmail_delete_messagePermanently delete a message. This action is irreversible — use gmail_trash_message for safe deletion.
gmail_trash_messageMove a message to the trash. Can be undone with gmail_untrash_message.
gmail_untrash_messageRemove a message from the trash, restoring it to its original location.
gmail_modify_messageAdd or remove labels on a message. Use this to mark as read/unread, star/unstar, or apply custom labels.
gmail_batch_deletePermanently delete multiple messages at once. Maximum 1000 IDs per request. Irreversible.
gmail_batch_modifyAdd or remove labels on multiple messages at once. Maximum 1000 IDs per request.
gmail_get_attachmentGet attachment data for a message. Returns base64url-encoded data. Find attachment IDs in the message payload parts.
gmail_list_draftsList all drafts in the mailbox.
gmail_get_draftGet a specific draft by ID, including the draft message content.
gmail_create_draftCreate a new draft email. The draft can be sent later with gmail_send_draft.
gmail_update_draftUpdate an existing draft with new content. Replaces the entire draft message.
gmail_delete_draftDelete a draft. This permanently removes the draft.
gmail_send_draftSend an existing draft. The draft is removed from the drafts list after sending.
gmail_list_labelsList all labels in the mailbox, including system labels (INBOX, SENT, etc.) and user-created labels.
gmail_get_labelGet details for a specific label, including message and thread counts.
gmail_create_labelCreate a new user label for organizing messages.
gmail_update_labelUpdate a label name, visibility, or color.
gmail_delete_labelDelete a user-created label. System labels cannot be deleted. Messages with this label are not deleted.
gmail_list_threadsList email threads (conversations). Supports the same search syntax as gmail_list_messages.
gmail_get_threadGet all messages in a thread (conversation). Returns the complete email chain.
gmail_modify_threadAdd or remove labels on all messages in a thread.
gmail_trash_threadMove all messages in a thread to the trash.
gmail_untrash_threadRemove all messages in a thread from the trash.
gmail_get_profileGet the authenticated user's Gmail profile — email address, total message count, total thread count, and history ID.
gmail_update_vacationEnable or disable vacation auto-reply (out of office) with custom response message.