SubsNotes

Know what you pay. Decide what to keep.
A private subscription list with payment history you can check and correct.

Try the fictional demo · Download the Claude skill · 繁體中文

_{Alpha.12 preview · Main experience: Claude web + Gmail · No SubsNotes desktop app required. Release notes and download checksums}

_{Fictional demonstration data. No personal mail, billing records or credentials are included.}

What you can do

• Find subscriptions in Gmail. Review services, recorded prices, renewal notices and original source emails.
• See recorded spending. Keep original currencies and inspect payments by month. Annual charges stay whole in their payment month.
• Confirm what you know. Record an exact payment date or just a month. User confirmations are labeled separately from email evidence.
• Keep your corrections. Reopen the same dashboard and rescan without silently replacing your confirmations.
• Choose your next step. Open a provider's management page or leave a review note. Cancellation stays with the provider.
• Use English or Traditional Chinese. Switch languages without creating another ledger.

The demo runs on fictional data. It does not connect Gmail, send reminders or cancel subscriptions.

Choose how to use SubsNotes

Option	Use it for	Start here
Claude web — main experience	Find subscriptions in Gmail and reopen your saved private dashboard.	Download the skill · Setup guide
Browser demo	Explore the interface using fictional records, without an account.	Open the demo
Local MCP Reader — optional	Let a compatible desktop assistant read a chosen local evidence folder.	Reader setup
macOS app — experimental source	Build a separate native client with a menu bar, hotkey and local reminders.	Source build and Gmail setup

The MCP Reader does not connect Gmail or automatically read the Claude web ledger. The macOS client requires macOS/Xcode and separate configuration; alpha.12 does not include a ready-to-install macOS app. Neither local option is required for the main Claude web experience.

Start in Claude

You need: a Claude account with Gmail, code execution, and native Artifact connectors/personal storage available. Personal Artifact storage requires an eligible paid Claude plan. SubsNotes itself adds no subscription, model API key, hosting account or separate desktop app.

1. Install the skill. Download subsnotes-subscription-review.zip for alpha.12, then upload and enable it in Claude's skill settings. Menu names can vary by account. If the download does not start, open the alpha.12 release page and expand Assets.

2. Connect Gmail in Claude. Check the account and the requested read-only access. Installing a skill does not grant Gmail access.

3. Ask Claude:

   Use SubsNotes to find my personal subscriptions. Keep the ledger private and show the saved dashboard in English.

Check Only you before continuing. Bookmark the resulting private Artifact and reopen that same dashboard next time. A new Artifact has a different store.

Already have a dashboard? Open its saved private link. You do not need another installation or a newly generated dashboard. Full usage guide →

Confirm a payment

Open an invoice or payment record, choose Confirm payment, check the amount and currency, then select Exact date or Month only. Save and wait for confirmation before closing the page.

Month-only confirmation records the month without inventing a day. Confirmed by you means a user-reported payment; it does not claim bank reconciliation. You can edit or remove a confirmation while retaining the original evidence. See payment rules and corrections.

How AI fits

flowchart LR
    Gmail[Your connected Gmail] --> Extract[Find and extract billing evidence]
    Extract --> Ledger[Private source records]
    You[Your payment confirmations] --> Ledger
    Ledger --> Rules[Deterministic dates, deduplication and totals]
    Rules --> Dashboard[The same saved dashboard]
    Dashboard --> Sources[Original emails and provider links]

Loading

Your existing assistant helps find and explain evidence. SubsNotes keeps source history, your confirmations and spending rules together. An AI suggestion cannot declare itself a user confirmation. How it works →

A few important limits

• Email is dated evidence, not a live provider account or bank feed. Missing mail does not prove cancellation.
• Refresh reloads saved records; Check Gmail searches for changes. Optional checks run only while the page is open and visible.
• Review dates are notes in the dashboard. They do not send notifications.
• Reference-currency conversion is an estimate; original-currency amounts remain available.
• Keep one editable dashboard open during updates. Host availability and permissions still apply.

Prefer a local sample?

Requires Node.js 22+ and npm. No account, API key or cloud database is needed for the fictional sample.

git clone https://github.com/ChristimCiel/SubsNotes.git
cd SubsNotes
npm ci --prefix renew-before-service
npm run sample
npm start

Open http://127.0.0.1:4183/ and stop with Ctrl+C. The sample refuses to overwrite existing data. The local report is read-only. Other ways to use SubsNotes →

Source layout

Renew Before is the earlier project name. SubsNotes retains those source-folder names and existing app/storage identifiers for compatibility.

Folder	Contents
renew-before-service/	Shared billing rules, Claude dashboard/skill, local report and MCP Reader.
renew-before-demo/	Browser demo sources and generated demo output.
renew-before-mac/	Optional experimental native macOS client.
guide/	English and Traditional Chinese usage documentation.

Help and community

I want to…	Read
Connect, confirm, edit or reopen	Usage
Understand the AI and storage boundaries	How it works
Fix a blank panel, missing record or failed save	FAQ & troubleshooting
Choose a download or update safely	Downloads & updates
Understand data access and report a vulnerability	Security & privacy
Report a bug or contribute	Contributing

Bug reports and small improvements are welcome. Use fictional examples and synthetic screenshots in public Issues. Never upload private receipts, mailbox exports, account links or credentials.

License

MIT. Commercial and noncommercial use are both permitted under its terms. Contributors retain copyright to their work. Dependencies, service marks and artwork retain their own notices; displaying a service does not imply affiliation. License FAQ