Gmail Auto Labeller
Gmail Auto Labeller
Automatically organise your inbox based on a simple Google Sheet. Smart, efficient, and entirely under your control.
Gmail Auto Labeller is a Chrome Extension that helps you keep your inbox organised effortlessly. By linking to a Google Sheet containing sender-to-label mappings, the extension automatically scans your Gmail and applies the appropriate labels to matching threads.
It works quietly in the background, keeping your inbox tidy based on the logic you define — no need for filters or manual tagging!
- Auto-labelling based on sender email address
- Syncs with Google Sheets in real time
- Creates labels if they don’t exist
- Respects user-defined refresh intervals
- One-click manual refresh available
- Fully private – uses your credentials securely via Google’s OAuth
This extension requires access to:
- gmail.modify – to label your threads
- gmail.labels – to create labels if necessary
- spreadsheets.readonly – to read your Google Sheet
- userinfo.email – to identify your account
1. Prepare Your Google Sheet
Your sheet should have this structure:
Email | Label
-------------------------------------
name1@email.com | Label 1
name2@email.com | Label 2
2. Note Your Sheet Details
- Sheet ID: Found in your Google Sheets URL
Example:
URL: https://docs.google.com/spreadsheets/d/123456789asdfghjkk/edit#gid=0
Sheet ID: 123456789asdfghjkk
Tab Name: The name of the worksheet (bottom tab in Google Sheets)
3. Configure the Extension
Upon first run, you'll be asked to provide:
- 📄 Google Sheet ID
- 🏷️ Tab Name
- 🔁 Refresh Interval (in minutes)
- 🕒 Email Lookback Period (in days)
4. Automatic Labelling
- The extension scans your Gmail inbox for emails from senders listed in your Google Sheet.
- If a match is found, the label is applied to the entire email thread.
- If the label does not already exist, it is created automatically.
5. Live Updates
Every run fetches the latest mapping from your Google Sheet — so if you update your sheet, it takes effect automatically.
6. Manual Refresh
You can trigger an instant refresh and re-labelling from within the extension at any time.
🔗 Get the Extension
👉 Install from Chrome Web Store
(Coming soon – this link will be updated when published)
📘 Documentation & Support
For detailed usage and troubleshooting, visit our Help Centre:
Help & Docs – Coming Soon
For support, contact: [email protected]