Shows setup and the recommended inbox workflow: fetch mode=list, triage metadata, get_thread one thread at a time, draft, send after approval.

Shows setup and the recommended inbox workflow: fetch mode=list, triage metadata, get_thread one thread at a time, draft, send after approval.

Start Gmail login with Connect you@example.com personal or Connect you@example.com work. Browser opens for approval. Then run connect_finish immediately to finish setup.

Start Gmail login with Connect you@example.com personal or Connect you@example.com work. Browser opens for approval. Then run connect_finish immediately to finish setup.

Finish Gmail login after browser approval. Waits if needed; no manual code copy required. After success, run set_signer, then fetch.

Finish Gmail login after browser approval. Waits if needed; no manual code copy required. After success, run set_signer, then fetch.

Calls the Gmail API to create the configured user labels (FOLLOW_UP_GMAIL_LABEL_*, GMAIL_REVIEW_GMAIL_LABEL_*) so they appear under Labels in Gmail—no manual label setup. Use this if labels did not appear after connect or fetch (e.g. old OAuth token missing gmail.modify — re-run npm run auth -- --alias ... then reconnect). Pass accountAlias / chatScope like other Gmail tools.

Calls the Gmail API to create the configured user labels (FOLLOW_UP_GMAIL_LABEL_*, GMAIL_REVIEW_GMAIL_LABEL_*) so they appear under Labels in Gmail—no manual label setup. Use this if labels did not appear after connect or fetch (e.g. old OAuth token missing gmail.modify — re-run npm run auth -- --alias ... then reconnect). Pass accountAlias / chatScope like other Gmail tools.

Returns token file aliases (strings). Pass one as accountAlias on other tools when the MCP client shares one default session across chats.

Returns token file aliases (strings). Pass one as accountAlias on other tools when the MCP client shares one default session across chats.

Saves the display name used on reply drafts for this session, and optionally the Gmail follow-up label name. Call after login when the user says how they want to sign. Advanced: chatScope / accountAlias only if README multi-account or shared-session section applies.

Saves the display name used on reply drafts for this session, and optionally the Gmail follow-up label name. Call after login when the user says how they want to sign. Advanced: chatScope / accountAlias only if README multi-account or shared-session section applies.

Choose standard (default) or compact response mode for this chat scope.

Choose standard (default) or compact response mode for this chat scope.

Shows account connection, signer name, last inbox batch, due follow-ups, and local paths. Use this first when unsure what to do next.

Shows account connection, signer name, last inbox batch, due follow-ups, and local paths. Use this first when unsure what to do next.

Verifies credentials path, accounts storage, reminders store, and active account binding, then suggests the next action.

Verifies credentials path, accounts storage, reminders store, and active account binding, then suggests the next action.

Recommended: mode=list (default) returns lightweight metadata for triage (subject, snippet, threadId). Snippets are not full email bodies — call get_thread(threadId) for each thread the user should read or reply to, and present message.text verbatim (do not summarize). Never load multiple full threads in one context. queryMode=inbox (default) prepends inbox review filters (in:inbox, exclude follow-up label). queryMode=raw passes query to Gmail unchanged — use for sent mail, archives, all-mail, and date-filtered analysis (e.g. in:sent after:2026/01/01). Legacy mode=full batch-loads bodies and auto-drafts every thread (token-heavy; avoid for normal inbox review). Nothing is sent automatically.

Recommended: mode=list (default) returns lightweight metadata for triage (subject, snippet, threadId). Snippets are not full email bodies — call get_thread(threadId) for each thread the user should read or reply to, and present message.text verbatim (do not summarize). Never load multiple full threads in one context. queryMode=inbox (default) prepends inbox review filters (in:inbox, exclude follow-up label). queryMode=raw passes query to Gmail unchanged — use for sent mail, archives, all-mail, and date-filtered analysis (e.g. in:sent after:2026/01/01). Legacy mode=full batch-loads bodies and auto-drafts every thread (token-heavy; avoid for normal inbox review). Nothing is sent automatically.

Load one Gmail thread at a time (use after fetch mode=list). format=full (default) returns plain-text message bodies. Use stripped=false to read the full email; stripped=true removes quoted reply history when drafting in multi-message threads. format=latest trims to first + latestN messages. Present message.text verbatim to the user — do not summarize. Call separately per thread.

Load one Gmail thread at a time (use after fetch mode=list). format=full (default) returns plain-text message bodies. Use stripped=false to read the full email; stripped=true removes quoted reply history when drafting in multi-message threads. format=latest trims to first + latestN messages. Present message.text verbatim to the user — do not summarize. Call separately per thread.

Archive a Gmail thread for the active account by removing the INBOX label. Use threadId from fetch, followup_due, or get_thread.

Archive a Gmail thread for the active account by removing the INBOX label. Use threadId from fetch, followup_due, or get_thread.

Send one approved reply. Requires messageId (marks source read, threads send). Provide body; set format to text/html for HTML (default text/plain). Legacy html still supported. quoteOriginal (default true) appends Gmail-style quoted parent history below the new body. appendSignature (default true) appends the account Gmail signature from Settings above the quote block. For new outbound / campaigns use send_new instead. Never run without explicit approval.

Send one approved reply. Requires messageId (marks source read, threads send). Provide body; set format to text/html for HTML (default text/plain). Legacy html still supported. quoteOriginal (default true) appends Gmail-style quoted parent history below the new body. appendSignature (default true) appends the account Gmail signature from Settings above the quote block. For new outbound / campaigns use send_new instead. Never run without explicit approval.

Send one approved new email. Use for campaigns and cold outreach — no messageId. Optional threadId from a prior send to add the next message in the same Gmail thread (campaign email 2+). Requires to and subject; German/Unicode subjects are RFC 2047–encoded automatically. Provide body with format text/html for HTML campaigns (default text/plain). Legacy htmlBody still supported. Never run without explicit approval.

Send one approved new email. Use for campaigns and cold outreach — no messageId. Optional threadId from a prior send to add the next message in the same Gmail thread (campaign email 2+). Requires to and subject; German/Unicode subjects are RFC 2047–encoded automatically. Provide body with format text/html for HTML campaigns (default text/plain). Legacy htmlBody still supported. Never run without explicit approval.

Save/update a Gmail draft reply for a thread without sending. Requires messageId, to, subject, and body; use format text/html for HTML drafts (default text/plain). quoteOriginal (default true) appends Gmail-style quoted parent history so drafts show the collapsible history expander in Gmail. appendSignature (default true) appends the account Gmail signature from Settings above the quote block.

Save/update a Gmail draft reply for a thread without sending. Requires messageId, to, subject, and body; use format text/html for HTML drafts (default text/plain). quoteOriginal (default true) appends Gmail-style quoted parent history so drafts show the collapsible history expander in Gmail. appendSignature (default true) appends the account Gmail signature from Settings above the quote block.

Create follow-up reminders using daysList or pattern, or update the existing open follow-up plan for the same thread. For daysList: [1, 3]: follow-up 1 is due in 1 day from now; follow-up 2 is due 3 days after follow-up 1 is sent (not 3 days from today). Each value after the first is always an interval after the previous follow-up send. Example: 1 day, then 3 days after the first — use [1, 3], not [1, 2].

Create follow-up reminders using daysList or pattern, or update the existing open follow-up plan for the same thread. For daysList: [1, 3]: follow-up 1 is due in 1 day from now; follow-up 2 is due 3 days after follow-up 1 is sent (not 3 days from today). Each value after the first is always an interval after the previous follow-up send. Example: 1 day, then 3 days after the first — use [1, 3], not [1, 2].

List reminders due now for the active account and refresh thread state before review. Returns the refreshed full thread context for each due reminder. Always present the full draft to the user for proof-reading before any send action. Never call followup_send without explicit user approval.

List reminders due now for the active account and refresh thread state before review. Returns the refreshed full thread context for each due reminder. Always present the full draft to the user for proof-reading before any send action. Never call followup_send without explicit user approval.

Send one approved follow-up reminder. Re-checks the thread first and blocks send if customer already replied. Optional overrides: body, format (text/plain default, text/html for HTML), quoteOriginal (default true), appendSignature (default true). IMPORTANT: NEVER call without explicit user approval after showing the draft.

Send one approved follow-up reminder. Re-checks the thread first and blocks send if customer already replied. Optional overrides: body, format (text/plain default, text/html for HTML), quoteOriginal (default true), appendSignature (default true). IMPORTANT: NEVER call without explicit user approval after showing the draft.

Remove follow-up reminder(s) from the local store. Pass reminderIds, messageId, messageHeaderId, sourceThreadId, or followUpChainId. Use cancelChain: true with reminderIds to drop an entire chained sequence. Use deleteAll: true with confirm: true to clear all reminders for the account. Optionally removes the Gmail follow-up label when no reminders remain for a thread.

Remove follow-up reminder(s) from the local store. Pass reminderIds, messageId, messageHeaderId, sourceThreadId, or followUpChainId. Use cancelChain: true with reminderIds to drop an entire chained sequence. Use deleteAll: true with confirm: true to clear all reminders for the account. Optionally removes the Gmail follow-up label when no reminders remain for a thread.

List drafts saved in Gmail Drafts folder. Separate from inbox. Use to review unsent drafts.

List drafts saved in Gmail Drafts folder. Separate from inbox. Use to review unsent drafts.

Deprecated — prefer multi_gmail_fetch with queryMode=raw and a Gmail query such as in:sent after:2026/01/01 before:2026/04/01 for filtered sent-mail analysis. This tool still lists the latest messages in Gmail Sent without date/query filters.

Deprecated — prefer multi_gmail_fetch with queryMode=raw and a Gmail query such as in:sent after:2026/01/01 before:2026/04/01 for filtered sent-mail analysis. This tool still lists the latest messages in Gmail Sent without date/query filters.