jev-gmail-labeler

September 21, 2026 · View on GitHub

A tool that uses Jev and the GMail API to organize your emails with labels.

This is a work in progress. See TODO below.

Audience & Purpose

This is intended primarily for personal use, so it's a little rough around the edges.

My plan is to set up a pub/sub subscriber to the GMail API in my homelab that runs jev-gmail-labeler whenever a new email comes in. The goal is to keep my inbox tidy and organized in near-real-time.

I'm making this project somewhat presentable in case it helps others who are learning about Jev. Because it's a new and promising model, and there aren't many practical examples of it being used in practice.

Installation

I have not published this to PyPI. Install it from this repository:

uv pip install "git+https://github.com/1npo/jev-gmail-labeler.git"

Auth

Put your TypeSafe API key in the TYPESAFE_API_KEY environment variable.

Usage

You need to run a few jev-gmail-labeler commands in a sequence.

Note

Each command currently gets its input from a JSON file and saves its output to a JSON file. So most commands currently depend on files generated by previous commands.

By default these files come from and are saved to a workspace/ folder in the current directory.

This behavior will change in the future.

jev-gmail-labeler get-emails -> workspace/email_cache.json
jev-gmail-labeler anonymize-emails -> workspace/anonymized_email_cache.json
jev-gmail-labeler classify-emails -> workspace/classification_cache.json
jev-gmail-labeler label-emails

Save workspace/classification_cache.json to a CSV file (workspace/report.csv) by running jev-gmail-labeler report.

Further Documentation

See ABOUT_JEV.md for my summary of what Jev is and how it works.

Not much else beyond that. See jev-gmail-labeler <command> --help for options you can provide for each command.

LLM Use Disclosure

The gmail_api_util.py module was entirely vibe-coded
Claude helped refactor a few functions in main.py
Claude helped with some research and troubleshooting