AI Gmail Auto-Labeler Agent using n8n and OpenAI

Unlock Automated Email Organization with this AI Agent

This n8n workflow deploys an AI Agent with the ability of intelligent email categorization and labeling. It connects to your Gmail account, processes new emails, and uses an OpenAI-powered Langchain agent to understand the email's content, subject, and sender. Based on this analysis and a set of configurable instructions, the agent either assigns the email to the most appropriate existing Gmail label or creates a new, well-structured label. It can even help declutter your inbox by removing the 'inbox' tag from less critical emails like promotions.

Key Features & Benefits

• AI-Powered Email Analysis: Leverages OpenAI's language models to deeply understand email content, sender, and subject for accurate categorization.
• Dynamic Label Management: Intelligently decides whether to use an existing Gmail label or create a new one, ensuring consistent organization.
• Contextual Label Creation: Creates new labels as sub-labels or under a designated 'AI' parent label if no direct match is found, maintaining a structured hierarchy.
• Inbox Decluttering: Can automatically remove the 'inbox' label for less important emails (e.g., promotions, newsletters), focusing your attention on what matters.
• Tool-Equipped Agent: Utilizes a suite of Gmail tools (read labels, get message, add label, create label) to perform its tasks autonomously within n8n.
• Customizable Logic: The agent's behavior, including label creation rules and criteria for distinguishing email importance, can be fine-tuned via its system prompt.

• An n8n instance (Cloud or self-hosted).
• OpenAI API Key with access to a suitable model (e.g., gpt-3.5-turbo or gpt-4).
• Gmail credentials configured for OAuth2 authentication in n8n.

1. Download the n8n workflow JSON file.
2. Import the workflow into your n8n instance.
3. Configure the 'Gmail Trigger' node: Authenticate with your Gmail account using OAuth2 and set your desired polling interval.
4. Configure the 'OpenAI Chat Model1' node: Enter your OpenAI API Key and select your preferred model.
5. Configure all 'Gmail - ...' tool nodes ('Gmail - read labels', 'Gmail - get message', 'Gmail - add label to message', 'Gmail - create label'): Ensure they are set up with the same Gmail OAuth2 credentials used in the trigger.
6. Review and customize the systemMessage in the 'Gmail labelling agent' node. This is where you define the AI's core instructions for analyzing emails and managing labels. Pay attention to the logic for creating new labels and handling different types of emails.
7. Adjust the 'Window Buffer Memory' node's sessionKey if needed, though ={{ $json.id }} (using the email ID) is generally a good default for per-email memory.
8. Activate the workflow.