Subscription Tracker

An AI skill for Claude that scans your Gmail to surface upcoming subscription renewals, recurring payments, and billing deadlines — organized by urgency so you know what needs attention now vs. later.

What It Does

• Searches Gmail for receipts, invoices, renewal notices, and billing alerts from the last 30 days
• Extracts structured data: service name, amount, renewal date, plan tier, billing cycle, cancellation deadline, payment links
• Prioritizes by urgency: 🔴 This Week → 🟠 This Month → 🟡 Next 3 Months → ⚪ Later This Year
• Generates an interactive dashboard (React artifact) with search, filters, and sortable columns
• Exports to spreadsheet (.xlsx) with color-coded urgency tiers and auto-filters

Supported Platforms

Works with subscription emails from any service, with optimized parsing for:

• Payment processors: Stripe, Razorpay, PayPal
• Streaming: Netflix, Spotify, Disney+, YouTube Premium
• Productivity: Adobe, Microsoft 365, Notion, Slack, Zoom
• Cloud/Dev: AWS, Google Cloud, Vercel, GitHub, Cursor
• AI Tools: Anthropic (Claude), OpenAI, Lovable, Emergent
• India-specific: JioCinema, Hotstar, Zomato, Swiggy, Paytm

Prerequisites

• Claude.ai Pro/Max plan (or Claude Code)
• Gmail MCP connector enabled in Claude
• Code execution enabled in Settings → Capabilities

Installation

Claude.ai

1. Download the latest subscription-tracker.skill from Releases
2. Go to Customize → Skills in Claude.ai
3. Click "Add skill" and upload the .skill file
4. Make sure the toggle is on

Claude Code

# Add this repo as a plugin marketplace
/plugin marketplace add YOUR_USERNAME/subscription-tracker

# Or install directly
/plugin install subscription-tracker@YOUR_USERNAME-skills

Manual (Claude Code)

# Clone to your skills directory
git clone https://github.com/YOUR_USERNAME/subscription-tracker.git
cp -r subscription-tracker/subscription-tracker ~/.claude/skills/

Usage

Just ask Claude naturally:

• "What subscriptions am I paying for?"
• "Show me my upcoming renewals"
• "Do a subscription audit on my email"
• "When is my next bill due?"
• "Am I still paying for Spotify?"
• "What's renewing this week?"

Claude will automatically use this skill when it detects subscription-related questions.

How It Works

1. Search: Runs 7 targeted Gmail queries to find billing/receipt/renewal emails
2. Filter: Removes false positives (newsletters, marketing emails, job alerts)
3. Parse: Extracts structured data from each billing email (checks both snippet and body)
4. Project: Calculates next renewal dates from past payments + billing cycle
5. Prioritize: Assigns urgency tiers based on how soon each renewal is due
6. Display: Renders an interactive React dashboard with xlsx export

Updating

Claude.ai

1. Go to Customize → Skills
2. Delete the existing subscription-tracker skill
3. Upload the new .skill file from Releases

Claude Code

/plugin update subscription-tracker

File Structure

subscription-tracker/
├── SKILL.md                        # Main skill instructions
├── scripts/
│   └── generate_xlsx.py            # Spreadsheet export with urgency styling
└── references/
    └── search_queries.md           # Common subscription sender patterns

Contributing

Contributions welcome! Some ideas:

• Add support for more payment processor email formats
• Improve date parsing for non-English locales
• Add calendar integration to set renewal reminders
• Support for SMS/WhatsApp payment notifications

License

MIT — see LICENSE for details.