Gmail MCP
РаботаетGmail MCP — официальный сервер Google для почты (Developer Preview): 10 инструментов вроде create_draft, search_threads и label_thread дают агенту работу с черновиками, тредами, поиском и метками на естественном языке. Единый эндпоинт по JSON-RPC поверх HTTPS, авторизация — OAuth 2.0. Для подключения как кастомного коннектора в Claude.ai нужен платный план (Pro, Max, Team или Enterprise).
Почему этот сервер
- Официальный MCP Gmail от Google (Developer Preview) — черновики, треды, поиск и метки
- 10 инструментов: от create_draft и search_threads до label_thread и unlabel_message
- JSON-RPC поверх HTTPS — работает как обычный remote MCP-эндпоинт в любом клиенте
- Для кастомных коннекторов в Claude.ai нужен план Pro, Max, Team или Enterprise
Примеры использования
Запрос агенту: Найди все письма от support за последнюю неделю и создай черновик ответа с извинениями за задержку
Результат: Агент вызвал search_threads по отправителю и дате, затем create_draft с текстом ответа — черновик появился в Gmail без ручного поиска.
Запрос агенту: Пометь все письма с темой «Счёт» меткой Финансы
Результат: Агент прошёл по search_threads по теме письма и вызвал label_thread с меткой Финансы для каждого найденного треда.
Здоровье
120 пометок за 30 дней · Последняя пометка: 21 нояб. 2026 г.
Пометки по дням (30 дней)
| date | работает | частично | сломан |
|---|---|---|---|
| 2026-10-23 | 4 | 0 | 0 |
| 2026-10-24 | 4 | 0 | 0 |
| 2026-10-25 | 4 | 0 | 0 |
| 2026-10-26 | 4 | 0 | 0 |
| 2026-10-27 | 4 | 0 | 0 |
| 2026-10-28 | 4 | 0 | 0 |
| 2026-10-29 | 4 | 0 | 0 |
| 2026-10-30 | 4 | 0 | 0 |
| 2026-10-31 | 4 | 0 | 0 |
| 2026-11-01 | 4 | 0 | 0 |
| 2026-11-02 | 4 | 0 | 0 |
| 2026-11-03 | 4 | 0 | 0 |
| 2026-11-04 | 4 | 0 | 0 |
| 2026-11-05 | 4 | 0 | 0 |
| 2026-11-06 | 4 | 0 | 0 |
| 2026-11-07 | 4 | 0 | 0 |
| 2026-11-08 | 4 | 0 | 0 |
| 2026-11-09 | 4 | 0 | 0 |
| 2026-11-10 | 4 | 0 | 0 |
| 2026-11-11 | 4 | 0 | 0 |
| 2026-11-12 | 4 | 0 | 0 |
| 2026-11-13 | 4 | 0 | 0 |
| 2026-11-14 | 4 | 0 | 0 |
| 2026-11-15 | 4 | 0 | 0 |
| 2026-11-16 | 4 | 0 | 0 |
| 2026-11-17 | 4 | 0 | 0 |
| 2026-11-18 | 4 | 0 | 0 |
| 2026-11-19 | 4 | 0 | 0 |
| 2026-11-20 | 4 | 0 | 0 |
| 2026-11-21 | 2 | 0 | 0 |
Инструменты сервера · 23
Собрано автопроверкой из tools/list — реальный список, не из описания.
apply_sensitive_message_labelPrefer `trash_message` or `mark_message_spam` instead. Adds a sensitive label (Trash or Spam) to a single message in the authenticated user's Gmail account. Use `apply_sensitive_message_label` when applying Trash or Spam to exactly 1 message. If the message belongs to a thread that should be labeled as a whole, prefer `trash_thread` or `mark_thread_spam`. To find the message ID, use the `get_thread` tool. To find the draft message ID, use tools like `list_drafts`.
apply_sensitive_thread_labelPrefer `trash_thread` or `mark_thread_spam` instead. Adds a sensitive label (Trash or Spam) to a single thread in the authenticated user's Gmail account. This operation affects all messages currently in the thread. Use `apply_sensitive_thread_label` when applying Trash or Spam to exactly 1 thread.
create_draftCreates a new draft email in the authenticated user's Gmail account. This tool takes recipient addresses (`to`, `cc`, `bcc`), a `subject`, and body content as inputs. Plain text body content can be provided in `body` (do NOT format `body` with Markdown), and rich-text HTML content can be provided in `htmlBody` (use valid HTML tags for formatting; if both are provided, `body` serves as the plain-text alternative). If the draft is created as a reply to an existing message, the ID of the original message should be passed to the tool in the `replyToMessageId` field. Set `includeSignature` to true to append the user's configured Gmail web signature to the draft. Returns a Draft object with the `id`, `threadId`, and `viewUrl` fields populated.
create_labelCreates a new label in the authenticated user's Gmail account. Supports creating nested labels (sub-labels) using a forward slash (e.g., 'Projects/Alpha/Sprint-1'). By default, parent labels will be automatically created if they do not exist.
get_draftRetrieves a specific draft email from the authenticated user's Gmail account by ID, including its `viewUrl` for viewing and editing in the Gmail Web UI. The optional `messageFormat` parameter controls the format of the draft returned. By default (or with `PLAIN_TEXT`), it returns the plain text body without the HTML body. Use `MINIMAL` to return snippet and key headers, `METADATA_ONLY` to exclude snippet, subject, and body, `FULL_CONTENT` for the complete draft including the HTML body, or `RAW` for the raw MIME message content.
get_messageRetrieves a specific email message from the authenticated user's Gmail account by its unique message ID, including its `viewUrl`. Use this tool to inspect a single, individual email when you already know its message ID. If the user wants to read a specific email in detail, check the exact wording of a message, or examine attachment metadata for a single email, this is the right tool. It is not suitable for retrieving entire conversations or viewing back-and-forth discussion threads; use the 'get_thread' tool instead. Note: This tool does not support retrieving draft messages. To view drafts, use the 'list_drafts' tool instead. Key indicators include if the user asks for the full content of a specific message ID returned by a previous search, or if the query asks to inspect a specific individual email rather than an entire thread. Example user prompts are: "Get the full text of message ID 18f123456789abcd.", "Read the latest message in that thread from Alice.", and "What are the attach
get_threadRetrieves a specific email thread from the authenticated user's Gmail account, including its `viewUrl` and a list of its messages (each with their own `viewUrl`). Note: This tool does not support retrieving drafts. Any draft messages within a thread are omitted. To view drafts, use the `list_drafts` tool instead. The optional `messageFormat` parameter controls the format of the messages returned. By default (or with `PLAIN_TEXT`), it returns the plain text body without the HTML body. Use `FULL_CONTENT` only when the HTML body is needed. Use `MINIMAL` to include only subject and snippet (excluding body). Use `METADATA_ONLY` to include only basic metadata (message ID, thread ID, viewUrl, labels, timestamp, and size estimate).
label_messageAdds one or more labels to a specific message in the authenticated user's Gmail account. To find the message ID, use the `get_thread` tool. If unsure of a user label's ID, use the `list_labels` tool first to discover available labels and their IDs. To move a message to a different inbox category tab, add the target `CATEGORY_*` label (e.g. `CATEGORY_PERSONAL` for Primary); Gmail automatically removes the previous category. To move a specific message to Trash or mark it as Spam, please use the `trash_message` or `mark_message_spam` tool instead.
label_threadAdds labels to an entire thread in the authenticated user's Gmail account. This operation affects all messages currently in the thread and any future messages added to it. If unsure of a user label's ID, use the `list_labels` tool first to discover available labels and their IDs. To move a thread to a different inbox category tab, add the target `CATEGORY_*` label (e.g. `CATEGORY_PERSONAL` for Primary); Gmail automatically removes the previous category. To move a thread to Trash or mark it as Spam, please use the `trash_thread` or `mark_thread_spam` tool instead.
list_draftsLists draft emails from the authenticated user's Gmail account, optionally filtered by a query string. Note: An empty JSON object `{}` represents zero matching items, not an error.
list_labelsLists all labels available in the authenticated user's Gmail account. Use this tool to discover the `labelId` and display `name` of each label in `labels` before calling `label_thread`, `unlabel_thread`, `label_message`, or `unlabel_message`. Note: the system labels, `DRAFT` and `SENT`, cannot be set on messages and are read only. Inbox category tabs are represented by system labels: `CATEGORY_PERSONAL` (Primary), `CATEGORY_SOCIAL` (Social), `CATEGORY_PROMOTIONS` (Promotions), `CATEGORY_UPDATES` (Updates), and `CATEGORY_FORUMS` (Forums). A message has at most one category: adding a category label moves the message to that tab and automatically removes its previous category, and removing a category label without adding another moves the message to Primary. Note: An empty JSON object `{}` represents zero matching items, not an error.
mark_message_spamMarks a specific message as Spam in the authenticated user's Gmail account. To find the message ID, use the `get_thread` tool.
mark_thread_spamMarks an entire thread as Spam in the authenticated user's Gmail account. This operation affects all messages currently in the thread. Use `mark_thread_spam` when marking a thread as spam, even if it currently contains only 1 message. Marking spam at the thread level ensures all current messages in the thread are marked as Spam.
search_threadsLists email threads from the authenticated user's Gmail account. This tool can filter threads based on a query string and supports pagination. It returns a list of threads, each with its thread `id`, `messageCount` (total messages in the thread), `viewUrl`, and a subset of up to 5 related messages (each with its own message `id`, `viewUrl`, `sender`, recipients, `date`, and `labelIds`). Use this tool to find thread `id`s matching a query before reading full threads or performing actions on matching emails or threads. The `view` parameter controls which additional fields are populated in the returned message subset. By default (or with `THREAD_VIEW_MINIMAL`), it includes `subject` and `snippet`. Use `THREAD_VIEW_METADATA_ONLY` to exclude `subject` and `snippet`, `THREAD_VIEW_SUMMARY` to return `THREAD_VIEW_MINIMAL` fields with only the most recent message per thread, or `THREAD_VIEW_IDS_ONLY` to return only `id` on each thread without fetching per-thread message metadata. Full message
trash_messageMoves a specific message to the Trash (soft delete) in the authenticated user's Gmail account. This is the default tool (along with `trash_thread`) when a user asks to 'delete', 'remove', or 'get rid of' a message without explicitly requesting permanent, irreversible deletion. Use `trash_message` when targeting a specific message within a thread. To trash an entire thread or a single-message thread, prefer `trash_thread`. To find the message ID, use the `get_thread` tool. To find the draft message ID, use tools like `list_drafts`.
trash_threadMoves an entire thread to the Trash (soft delete) in the authenticated user's Gmail account. This operation affects all messages currently in the thread. This is the default tool (along with `trash_message`) when a user asks to 'delete', 'remove', or 'get rid of' an email or thread without explicitly requesting permanent, irreversible deletion. Use `trash_thread` when trashing a thread, even if it currently contains only 1 message. Trashing at the thread level ensures all current messages in the thread are moved to Trash.
unlabel_messageRemoves one or more labels from a specific message in the authenticated user's Gmail account. To find the message ID, use the `get_thread` tool. If unsure of a user label's ID, use the `list_labels` tool first to discover available labels and their IDs.
unlabel_threadRemoves labels from an entire thread in the authenticated user's Gmail account. This operation affects all messages currently in the thread. Use `unlabel_thread` when removing labels from an email or thread (such as marking it as read by removing `UNREAD`, archiving it by removing `INBOX`, or removing user-defined labels), even if the thread currently contains only 1 message. If unsure of a user label's ID, use the `list_labels` tool first.
unmark_message_spamUnmarks a specific message as Spam in the authenticated user's Gmail account. This does not return the message to the Inbox; to move it to the Inbox, add the `INBOX` label separately. To find the message ID, use the `get_thread` tool.
unmark_thread_spamUnmarks an entire thread as Spam in the authenticated user's Gmail account. This does not return the thread to the Inbox; to move it to the Inbox, add the `INBOX` label separately.
untrash_messageRemoves a specific message from the Trash in the authenticated user's Gmail account. This does not return the message to the Inbox; to move it to the Inbox, add the `INBOX` label separately. To find the message ID, use the `get_thread` tool.
untrash_threadRemoves an entire thread from the Trash in the authenticated user's Gmail account. This does not return the thread to the Inbox; to move it to the Inbox, add the `INBOX` label separately.
update_message_labelsAtomically adds and/or removes labels from a specific message in the authenticated user's Gmail account. Requires at least one of `addLabelIds` or `removeLabelIds` to be provided. Moving an email between labels can be accomplished in a single call by specifying the target label in `addLabelIds` and the current label in `removeLabelIds`. For inbox category tabs, adding the target `CATEGORY_*` label (e.g. `CATEGORY_PERSONAL` for Primary) is sufficient; Gmail automatically removes the previous category.
Отзывы
Отзывов пока нет.