Your inbox,
decoded.
Onyx Roots connects directly to Gmail to search, read, organise, and act on your email with precision. Four core operations. Unlimited intelligence.
Five steps from
connection to intelligence.
Every Onyx Roots workflow follows the same five-step pipeline, ensuring safety, precision, and transparency at every stage.
Connect
The Gmail MCP connector authenticates with your Gmail account using OAuth. No passwords are stored.
Search
Issue a Gmail-style search query. The connector returns message metadata, snippets, and thread IDs.
Read
Open selected threads by ID. Full plain-text content, headers, and attachment references are returned.
Analyse
Onyx Roots processes the results and produces structured reports, digests, or summaries.
Act
With explicit approval, labels can be created, messages drafted, and emails sent — never silently.
What I tested —
and what I found.
Every row reflects a real operation performed against your Gmail account on 20 May 2026. No data was modified.
| Test performed | Result | Notes |
|---|---|---|
| Connector availability | Successful | Four operations exposed and functional. |
| Label listing | Successful | 16 labels found, including custom label Advocate. |
| Label detail lookup | Successful | Advocate: 0 messages, 0 threads. |
| Recent inbox search | Successful | 5 messages returned with metadata and snippets. |
| Unread search | Successful | 6+ unread messages from the last 30 days. |
| Payment search | Successful | Multiple payment-failure and renewal notices found. |
| Attachment search | Successful | PDFs, ICS, CSV, and image attachments found. |
| Thread reading (full text) | Successful | Two payment threads read with amounts and deadlines. |
| Sending / drafting | Skipped | Not tested — modifies mailbox; requires confirmation. |
| Label modification | Skipped | Not tested — modifies mailbox. |
Four operations.
Everything you need.
The Gmail connector exposes a focused set of operations that cover the full lifecycle of mailbox intelligence — from discovery to action.
Search Messages
Search Gmail using any combination of sender, subject, date range, label, keyword, or Gmail-style operators. Returns metadata, snippets, message IDs, and thread IDs.
in:inbox is:unread newer_than:7dRead Threads
Open one or many email threads by ID. Returns snippets or full plain-text content including headers, body, and attachment references.
thread_id: "18f2a3b4c5d6"Manage Labels
List all labels, get label details, create new labels, update existing ones, delete labels, or apply and remove labels from specific messages.
operation: "list" | "get" | "create"Send Messages
Compose and send email or save as draft. Supports recipients, CC, BCC, subject, body, reply threading, and attachments. Always requires explicit confirmation before sending.
to: "[email protected]"Real messages.
Real intelligence.
Five most recent inbox messages fetched live from your Gmail account on 20 May 2026 using the in:inbox newer_than:30d search query. No data was modified.
PayPal payment was declined. Subscription may be cancelled unless payment is updated.
Mega Evolution: Chaos Rising landing at 7-Eleven on 22 May.
Newsletter including Google I/O recap and travel gadget coverage.
Notification that a seller sent an image.
Store reopening promotion with food, drinks, demos, and offers.
All 16 Gmail labels,
fully mapped.
The label listing operation returned every label in your Gmail account — 15 system labels and 1 user-created label. Labels are the foundation of every search and organisation workflow in Onyx Roots.
| Label | Type |
|---|---|
INBOX | System |
SENT | System |
DRAFT | System |
SPAM | System |
TRASH | System |
STARRED | System |
UNREAD | System |
IMPORTANT | System |
CATEGORY_PERSONAL | Category |
CATEGORY_SOCIAL | Category |
CATEGORY_PROMOTIONS | Category |
CATEGORY_UPDATES | Category |
CATEGORY_FORUMS | Category |
CHAT | System |
SCHEDULED | System |
Advocate | User |
Inside a real
payment thread.
This is the actual content returned when reading the Google Play payment decline thread using the gmail_read_threads operation.
What thread reading returns
thread_idUnique Gmail thread identifiermessage_idIndividual message ID within threadfrom / to / ccFull sender and recipient headerssubjectEmail subject linedateISO timestamp of the messagesnippetShort preview of the message bodybody (plain)Full plain-text message contentattachmentsFile names, MIME types, and sizesWhat needs your
attention now.
Onyx Roots identified these payment-related items by searching for keywords including payment, invoice, subscription, failed, declined, renewal, and expiry across the last 90 days.
| Priority | Item | Sender | Amount | Deadline | Recommended action |
|---|---|---|---|---|---|
| High | Google Play / Beatron subscription | Google Play | $15.99 | 21 May 2026 | Update PayPal payment method |
| High | Canva Business — Embrace Fragile X's Team | Canva | Not stated | 27 May 2026 | Check and update payment details |
| Medium | Websites.co.in trial expiry | Websites.co.in | Not stated | 15 May 2026 | Decide whether to renew |
| Medium | Origin Energy agreement PDFs | Origin Energy | N/A | N/A | Review and save 6 PDF attachments |
Find any file
in your inbox.
Using has:attachment search, Onyx Roots found these recent emails with attachments across the last 90 days.
From search to
structured intelligence.
Combining search, reading, and summarisation into repeatable workflows turns raw email into actionable intelligence.
Subscription Risk Report
Searches for payment, invoice, subscription, failed, and declined keywords. Extracts service name, sender, amount, deadline, and recommended action.
Daily Priority Digest
Searches recent inbox email and groups results into urgent, personal, work, newsletters, promotions, and low priority for a concise daily summary.
Unread Cleanup Assistant
Finds all unread messages, groups them by sender and topic, and suggests archive, delete, or label actions for review before any change is made.
Attachment Inventory
Searches for emails with attachments and builds a table of file names, senders, dates, and likely document types — PDFs, CSVs, images, calendar files.
Mailbox Organiser
Analyses your email patterns and proposes a labelling plan — Receipts, Health, Utilities, Shopping, Subscriptions — without changing anything until approved.
Drafting Assistant
Reads context from a selected thread and drafts a reply in your preferred tone. The draft is shown for review and never sent until you explicitly confirm.
Precision search.
Gmail-native syntax.
Onyx Roots accepts Gmail-style query strings. These examples can be combined for complex multi-condition searches.
| Search goal | Example query |
|---|---|
| Recent inbox email | in:inbox newer_than:7d |
| Unread email | is:unread |
| Unread inbox (last month) | in:inbox is:unread newer_than:30d |
| Email from Google Play | from:[email protected] |
| Payment-related email | payment OR invoice OR receipt OR subscription |
| Failed payment notices | payment failed OR payment declined OR action required |
| Emails after a date | after:2026/05/01 |
| Messages with attachments | has:attachment |
| PDFs from Origin | from:origin has:attachment filename:pdf |
| Starred messages | is:starred |
| Promotional messages | category:promotions |
| Messages with a subject keyword | subject:appointment |
Read first.
Act only with approval.
The most important safety distinction in Onyx Roots is the boundary between read-only and modifying operations. Searching, listing labels, and reading threads never alter your mailbox. Sending, drafting, and label management change mailbox state and require explicit approval.
"Every modifying action is shown for review before it is applied. Nothing is sent silently."
| Action | Type | Safe by default |
|---|---|---|
| Search messages | Read-only | Yes |
| List labels | Read-only | Yes |
| Get label details | Read-only | Yes |
| Read threads | Read-only | Yes |
| Create a label | Modifying | Requires approval |
| Update a label | Modifying | Requires approval |
| Delete a label | Modifying | Requires approval |
| Apply a label to messages | Modifying | Requires approval |
| Save draft | Modifying | Requires approval |
| Send message | Modifying — requires confirmation | Requires approval |
Your inbox is ready.
What do you want to know?
Ask for any of the reports below, or describe what you need in plain language. Onyx Roots will handle the rest.
