Gmail MCP capabilities

This catalog contains 18 public pages—one for every registered MCP tool in mcp-google-gmail. Each page starts with the user's task, explains the result, and states whether the call changes real data.

Use this catalog to choose a ready-made capability. Full parameter schemas and API response details remain in the technical reference.

Messages

Search and list messages — Gmail query syntax search with triage-ready summaries. Impact: read-only.
Read a message — one email fully decoded: headers, text/HTML bodies, attachment metadata. Impact: read-only.
Send an email — sends immediately and irreversibly; supports threaded replies. Impact: destructive operation.
Change message labels / state — read/unread, star, archive, apply/strip labels. Impact: destructive operation.
Trash or restore mail — reversible trash for messages and threads (~30 days). Impact: destructive operation.

Threads

Search and list threads — the same search at conversation granularity. Impact: read-only.
Read a whole conversation — every message of a thread decoded, oldest first. Impact: read-only.
Change thread labels / state — the modify_message flags for a whole conversation. Impact: destructive operation.

Drafts

Create a draft — prepare an email without sending; supports reply drafts. Impact: changes data.
List drafts — the unsent drafts and their ids. Impact: read-only.
Read a draft — the draft's content, decoded, for pre-send review. Impact: read-only.
Update a draft — replaces the whole draft message (no partial edit in the API). Impact: destructive operation.
Send a draft — sends the stored draft as-is, irreversibly. Impact: destructive operation.
Delete a draft — permanent; drafts skip the trash. Impact: destructive operation.

Labels

List labels — the label-id vocabulary; per-label counts on request. Impact: read-only.
Create, rename or delete a label — manage user labels; deletion is irreversible. Impact: destructive operation.

Profile

Get the mailbox profile — the connected address and counts; the cheapest credential check. Impact: read-only.

Additional API methods

Raw Gmail API call — escape hatch to any Gmail API v1 path (attachments, history, settings). Impact: destructive operation.