PHIL is a Chrome Extension that intelligently filters, summarizes, and organizes your Gmail inbox. Instead of drowning in a sea of unread messages, this tool fetches your latest emails, analyzes them using AI, labels them, and presents them in a clean, organized sidepannel.
-
AI-Powered Summarization: Automatically turns long email threads into one-sentence summaries.
-
Smart Labeling: Automatically detects and groups categories including "Spam," "Promotions," or "Important".
-
Smart Caching: Uses local storage to save analyzed email tags, reducing API calls and improves efficiency.
-
Intelligent Deduping: Automatically filters out emails you have already seen and handles "New" vs. "Read" states.
- Uses Java Script for all backend
- Uses CSS and HTML for the frontend
Uses an API and an AI Agent to smartly label emails:
- Google Gmail API -> get emails
- Google Gemini Flash 3 API -> reads and labels the emails.
Extension Installation for Local Development
-
Clone this repository.
-
pen Chrome and navigate to chrome://extensions/.
-
Toggle Developer mode in the top right corner.
-
Click Load unpacked.
-
Select the directory where you cloned this project.
Important notes:
- You must have an API key and a 'client-id' for the Gmail API and the Google Gemini Flash 3 respectively for the extension to run properly.
- The API key is stored in a private file called 'config.js'
- The client id is stored in a private file called 'manifest.json'
- We include a template that sould work so long as you put your client id in
We have future plans for this project, currently this is just the MVP that we were able to achieve in the timespan that we had. We plan to:
- Change the agent used to a fully local agent, specifically Google's Vertex Agent.
- This keeps the user's privacy secured on their own device without any open-to-the-public Agent/ AI.
- Updates to the UI for a better and more smooth experience.
- Added features:
- Time stamps on the email stubs
- Grouping email threads, so they look nicer and do not take up as much space
