Subscription Tracker MCP Server is an MCP (Model Context Protocol) server for personal use, designed for intelligent management of subscription and billing information. It integrates Gmail email retrieval, AI extraction, MySQL persistent storage, gap detection, and proactive reminders to help users automatically find subscription-related emails from their inbox and save key information in a structured way.
Purpose: It mainly solves the problems of subscriptions being scattered across emails, difficulty tracking renewals, duplicate subscriptions, and price changes. Through natural language instructions, users can have the AI assistant list all subscriptions, search emails for a specific service (such as Netflix), check renewals in an upcoming period, and detect duplicate subscriptions.
Main capabilities: The official description includes 16 MCP tools, covering Gmail search, AI extraction, MySQL CRUD, gap detection, and proactive reminders. The Gmail integration supports searching and extracting subscription emails; MySQL is used for persistent storage and state management; AI extraction is used to parse subscription details from emails; gap detection can discover duplicates, missing data, and price anomalies; proactive reminders support notification 3 days before renewal. The official description states that the accuracy of automatically extracting and structuring subscription and billing data from emails exceeds 90%.
How to use: The repository provides installation steps. First install dependencies; second configure MySQL; then configure the application; next set up Google OAuth, which requires downloading credentials.json from the Google Cloud Console and placing it in the project root directory, and running python3 src/setup.py; after that configure Claude Desktop by editing ~/Library/Application Support/Claude/claude_desktop_config.json; finally completely quit and reopen Claude Desktop. After configuration is complete, natural language instructions can be used, for example "List all my subscriptions", "Search Gmail for Netflix subscription emails", "Check for renewals in the next 7 days", "Detect duplicate subscriptions".
Applicable scenarios: Suitable for users who want to use an AI assistant to uniformly manage personal subscriptions, reduce manual organization, promptly discover duplicate subscriptions or price anomalies, and learn renewal dates in advance.
Limitations: This repository is explicitly marked as a personal use project (Personal use project). Other limitations, such as supported operating systems, specific MySQL versions, whether multiple users are supported, deployment methods, and billing or pricing information, are not yet provided in the materials.
