inbox-relay
This MCP server supports Gmail inbox triage: read/search mail, inspect threads and labels, label-and-archive high-confidence messages, and create unsent drafts; it cannot send mail.
Search the inbox using Gmail search syntax and return matching message IDs.
Fetch a full message, including headers, body, and labels.
List inbox threads, optionally filtered by a Gmail search query.
List all Gmail labels and their IDs.
Apply a label to a message and archive it out of the inbox; intended only for high-confidence classifications.
Create Gmail drafts for manual sending only; it never sends mail.
Provides tools for searching and reading Gmail mail, listing threads and labels, applying labels and archiving high-confidence threads, and creating draft replies without sending mail.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@inbox-relay Search my inbox for new recruiter emails from this week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
inbox-relay
An MCP server that triages a recruiter inbox: read, label, draft. It never sends mail — by permission, not by promise.
What it does
Searches and reads recruiter mail over Gmail
Labels threads into eight categories:
interview,offer-process,recruiter/new,recruiter/replied,rejects,application,read-later,promosArchives labeled mail out of the inbox (reversible — everything stays findable under its label)
Drafts replies for you to send manually
Related MCP server: Gmail Guardian
What it never does
Send mail. The only Gmail scope requested is
gmail.modify(read, label, archive, create drafts). Thegmail.sendscope is never requested, so sending is impossible even if the code tried.Auto-archive unsure mail. Low-confidence classifications stay in the inbox for human review.
Quickstart
npm install
npm run buildSet up a Google Cloud OAuth client (Desktop app), enable the Gmail API, and
put the credentials in your environment (see .env.example). Mint the token
with the auth helper — it prints a consent URL, you approve, and it saves the
token at GMAIL_TOKEN_PATH (gitignored, never committed):
GOOGLE_CLIENT_ID=... GOOGLE_CLIENT_SECRET=... npm run authThen:
npm start
# or inspect the tools live:
npm run inspectTools (v1)
Tool | What it does |
| Gmail search over the inbox |
| Fetch one message in full |
| Thread-level inbox view |
| All Gmail labels + ids |
| Label + archive (high-confidence only) |
| Draft only — you send it |
classify_message (category + priority + confidence + reason) lands in
Week 2 with the rubric-driven LLM classifier and the rules baseline.
Labels
See docs/annotation-guide.md for definitions,
signals, precedence rules, and the thread-history rule (cold-outreach vs
recruiter/new is decided by thread history, not memory).
Evals
The golden dataset is the contract: see evals/README.md.
Real mail stays local and gitignored; the public repo carries no real emails,
only the annotation guide and the eval methodology.
Project status
Week 1 scaffold: server skeleton, Gmail wiring for search/get/labels/drafts, taxonomy, annotation guide. Week 2: classifier + rules baseline scored. Week 3: draft tool polish, LLM classifier scored vs baseline, eval write-up.
License
MIT.
Available Tools
6 toolsapply_labelA
Label a message AND archive it out of the inbox (reversible). Only call this for high-confidence classifications; unsure messages stay in the inbox.
Inputs: label_id (required), message_id (required).
create_draftA
Create a Gmail DRAFT only. The user sends it manually. This never sends.
Inputs: to (required), body (required), subject (required).
get_messageB
Fetch one message in full: headers, body, and labels.
Inputs: id (required).
list_labelsA
List all Gmail labels with their ids (needed before apply_label).
Inputs: no named parameters.
list_threadsB
List inbox threads, optionally filtered by a Gmail search query.
Inputs: query.
search_messagesB
Search the inbox (Gmail search syntax). Returns matching message ids.
Inputs: query (required), max_results.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools target distinct resource+action pairs (search messages, fetch message, list labels, label+archive, draft). The only real overlap is search_messages vs list_threads, since both accept Gmail search queries, but the message-vs-thread distinction and the return shapes are stated clearly enough to pick correctly.
Every tool follows a clean verb_noun snake_case pattern: search_messages, get_message, list_threads, list_labels, apply_label, create_draft. No style mixing or vague verbs.
Six tools is tightly scoped for a triage/relay workflow: search, read, enumerate threads/labels, label-and-archive, and draft. Each tool earns its place with no filler.
Covers the core triage loop (find, read, classify, draft) well. Minor gaps: there is no tool to fetch a full thread (only list_threads) and no way to undo the archive/label despite apply_label being described as reversible, which leaves a potential dead end.
Maintenance
Related MCP Connectors
Search and triage all your mailboxes; draft replies and campaigns; send only as you allow.
Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…
Read and search FranklyMail email and prepare drafts, replies, and forwards for human approval.
Bring Gmail, Outlook, iCloud Mail, Yahoo Mail, Fastmail and other IMAP mailboxes together. Search connected email, including semantic search; cached or indexed results may be incomplete or stale. Read messages and attachments, create drafts, send or reply when requested, and manage rules for new mail. Separate permissions control reading, attachments, drafts, sending and mailbox changes.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to read unread Gmail messages and create threaded draft replies, without ever sending email automatically.MIT
- FlicenseNot gradedqualityDmaintenanceEnables intelligent Gmail management, including email triage, newsletter classification, promotional email cleanup, summarization, filter suggestions, draft replies, and audit logging.-
- FlicenseNot gradedqualityCmaintenanceEnables tracking job applications by connecting Gmail to retrieve emails, process job details, manage statuses, and generate statistics.-
- AlicenseAqualityBmaintenanceLets users search and read Gmail messages and threads, list labels, and create drafts via the official Gmail API, with self-hosted OAuth for privacy.53MIT