Image by Author
# Introduction
Email overload is real. You open your inbox to find dozens of messages, and you’re immediately playing mental triage. Which ones need attention now? Which can wait?
It’s exhausting, and it’s easy to miss something important while you’re drowning in notifications.
Here’s a better way: build an automated Gmail agent in n8n that scores every incoming email on a 0-100 scale and takes action based on priority. The system runs continuously and processes emails as they arrive.
Complete n8n workflow showing email scoring and priority-based routing | Image by Author
# Why n8n for Email Automation?
n8n makes this kind of automation straightforward. If you’re new to building workflows with n8n, start with this foundational guide first. The visual workflow design lets you see your entire logic at a glance. Native Gmail integration handles authentication without you wrestling with OAuth2. Code nodes give you full control over the scoring algorithm using JavaScript. Once it’s running, it processes emails 24/7 in the cloud.
# How the Workflow Works
The agent uses 13 nodes organized into a clear processing pipeline:
- Gmail Trigger monitors your inbox for new emails
- Advanced Email Scoring analyzes each message and calculates a priority score
- Route by Priority splits emails into four paths based on score
- Priority-specific actions execute appropriate tasks for each category
- Analytics logging tracks metrics so you can refine the system
Four priority levels handle different types of emails:
- Critical (75-100): Starred, labeled, triggers Slack alerts
- High (50-74): Labeled, creates tasks in your project manager
- Medium (30-49): Labeled, queued for daily review
- Low (0-29): Labeled, marked as read
# What You’ll Need
Before you start:
- An n8n account (cloud or self-hosted)
- A Gmail account for automation
- Optional: Slack webhook URL for critical alerts
- Optional: Task management API endpoint (Asana, Todoist, etc.)
Download the workflow JSON file (attached) and import it into your n8n instance. You’ll need to configure credentials for these nodes:
- Gmail Trigger & Gmail action nodes: Connect your Gmail OAuth2 credentials (setup guide).
- Slack node: Add your webhook URL (or disable this node if not needed).
- HTTP Request nodes (Task Manager): Add your task management API endpoints and authentication for high and medium priority tasks (or disable if not needed).
- HTTP Request (Analytics): Add your analytics endpoint or disable if not tracking externally.
The workflow will show credential warnings in n8n until configured. Start with Gmail credentials to test the core scoring logic, then add other integrations as needed.
# Setting Up the Gmail Trigger
The Gmail Trigger node polls your inbox every minute for new emails (you can adjust this interval in the node settings if needed). Configure it to watch only your INBOX folder so spam and trash don’t trigger the workflow.
When a new email arrives, the trigger captures everything you need: sender details, subject, body content (both plain text and HTML), attachments, and the message ID for tracking. Send yourself a test email to verify the trigger works, then check the execution log in n8n to see the scoring in action.
# How Email Scoring Works
The Code node implements a multi-factor scoring algorithm that examines three things:
Sender reputation: The algorithm starts with a base score and adjusts based on the sender’s domain, email address patterns, and whether they’re on your VIP list. Emails from noreply@ addresses get penalized. Messages from executives or important client domains get bonus points.
Content characteristics: The algorithm scans for urgency keywords (e.g. “ASAP,” “urgent,” “immediately”), checks for questions that need answers, and awards points for attachments.
Category classification: The system categorizes emails into buckets like client communications, finance, meetings, and technical issues. Client and finance emails get priority boosts.
The final score combines all three factors, capped at 100. You can see the full implementation in the attached JSON workflow (look for the “Advanced Email Scoring” node).
# Priority Routing and Actions
Once an email has a score, the Switch node routes it to the appropriate path.
// Critical Priority (75-100)
Urgent client requests, executive communications, time-sensitive issues. The workflow:
- Labels it “Priority_Critical” in Gmail
- Stars the message for quick access
- Sends a Slack alert with sender, subject, score, and timestamp
This three-layered approach means you’ll see critical emails no matter where you’re working.
// High Priority (50-74)
Meeting requests from stakeholders, client questions, project updates. The workflow:
- Labels it “Priority_High”
- Creates a task in your project manager with details and a link back to the email
These emails automatically enter your task workflow.
// Medium Priority (30-49)
Team updates, informational messages, standard business communications. The workflow:
- Labels it “Priority_Medium”
- Queues it for review during dedicated email time
You can batch-process these later.
// Low Priority (0-29)
Newsletters, automated notifications, marketing emails. The workflow:
- Labels it “Priority_Low”
- Marks it as read
It’s been triaged and filed.
# Tracking What’s Working
The analytics node runs in parallel with everything else and captures metrics from every email: timestamp, sender domain, priority score and level, category, and actions taken.
This data helps you validate the scoring algorithm. Which senders consistently generate high-priority emails? What categories are you getting most? You can refine the system based on real data.
# Customizing for Your Needs
The workflow is designed to be modified. Here’s what you’ll typically want to change:
VIP domains: Open the “Advanced Email Scoring” node in the JSON and find the vipDomains array. Add domains for your important clients, partners, and company accounts.
Keyword categories: The algorithm uses keyword lists to classify emails. If you’re in finance, add terms like “audit,” “compliance,” “regulation.” Data scientists might add “model,” “dataset,” “pipeline.” Customize these based on what matters in your work.
Priority thresholds: If you’re getting too many critical alerts, raise the threshold from 75 to 80. If you’re missing important emails, lower it to 70. Monitor your patterns for the first week and adjust.
External services: Replace the placeholder URLs with your actual Slack webhook, task manager API, and analytics endpoints. If you don’t use certain services, disable those nodes or swap in alternatives.
# When Things Go Wrong
- Emails aren’t triggering: Check that the Gmail Trigger is active and polling every minute. Test your Gmail credentials.
- Priority scores seem off: Review the keyword lists and add domain-specific terms. Adjust point values based on your email patterns.
- Slack notifications fail: Verify your webhook URL and permissions. Test it outside n8n first.
- Gmail labels aren’t applied: Create the labels manually in Gmail before running the workflow: Priority_Critical, Priority_High, Priority_Medium, Priority_Low. Or modify the workflow to use labels you already have.
# Taking It Further
Right now, this is an automated workflow that follows predefined rules. Once it’s running well, you can transform it into a true autonomous agent by adding these capabilities:
AI integration: Add OpenAI or Claude to perform semantic analysis of email content. This moves beyond keyword matching to actual understanding. The AI can extract action items, detect sentiment, and even generate draft responses. This is where the workflow becomes an agent — making intelligent decisions rather than following static rules.
Sender learning: Track which senders you consistently respond to quickly. The workflow could learn your implicit priorities and adjust scores accordingly over time. This adaptive behavior is a key characteristic of agent-based systems.
Thread tracking: Track email conversations over time. Emails in active threads could get automatic priority bumps based on context and conversation history.
Smart auto-responses: Detect frequently-asked questions and send templated replies instantly, with the AI learning which responses work best.
Calendar integration: When emails mention meetings or deadlines, automatically create calendar events with intelligent scheduling suggestions.
# Wrapping Up
This n8n workflow transforms email from an interruption into an organized system. Every incoming message gets analyzed and prioritized automatically.
Start with the foundation, then add sophistication as you go. Customize the scoring to match your communication patterns. Adjust thresholds based on your needs. Integrate with the tools you already use.
Download the workflow, connect your Gmail, customize the scoring logic, and take back control of your inbox.
# Recommended Resources
Vinod Chugani was born in India and raised in Japan, and brings a global perspective to data science and machine learning education. He bridges the gap between emerging AI technologies and practical implementation for working professionals. Vinod focuses on creating accessible learning pathways for complex topics like agentic AI, performance optimization, and AI engineering. He focuses on practical machine learning implementations and mentoring the next generation of data professionals through live sessions and personalized guidance.
