gmail-ai-unsub

🥈Silver

AI-powered CLI tool to identify and automatically unsubscribe from marketing emails in Gmail. Uses LLMs (Gemini, Claude, OpenAI) and browser automation to clean up inboxes. Benefits marketing teams by reducing email clutter and improving productivity.

920Updated 1w ago

Intermediate30min to implementmarketing

Saves ~20 min per use

Quick InstallView Source

git clone https://github.com/zbowling/gmail-ai-unsub.git

Works with:

Claude

Overview

About This Skill

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/zbowling/gmail-ai-unsub

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

I want to use the Gmail AI Unsubscribe Tool to clean up my inbox. I receive a lot of marketing emails from [COMPANY] in the [INDUSTRY] sector. Can you guide me through the process of setting up and running this tool to automatically unsubscribe from these emails?

Example Output

# Gmail AI Unsubscribe Tool Setup Guide

## Prerequisites
- Python 3.8 or higher
- Google Chrome or Chromium browser
- A Google account with access to Gmail

## Installation
1. Clone the repository:
   ```bash
   git clone https://github.com/yourusername/gmail-ai-unsubscribe.git
   ```
2. Install the required dependencies:
   ```bash
   pip install -r requirements.txt
   ```

## Configuration
1. Open the `config.json` file and enter your Google account credentials.
2. Specify the LLM you want to use (Gemini, Claude, or OpenAI).
3. Set the frequency of the unsubscribe checks (daily, weekly, or monthly).

## Running the Tool
1. Execute the script:
   ```bash
   python main.py
   ```
2. The tool will scan your inbox for marketing emails and present a list of senders.
3. Confirm the senders you want to unsubscribe from.
4. The tool will automatically unsubscribe you from the selected senders.

## Expected Output
- A list of marketing email senders identified in your inbox.
- Confirmation of successful unsubscription from selected senders.
- A log of all actions performed by the tool.