Skip to main content
Glama
Life Admin MCP

Life Admin MCP

by NKC27

Life Admin MCP

Never miss a bill, never pay a loyalty penalty, and always know what's safe to spend.

Your bills, renewals, subscriptions, birthdays and spending, kept as plain files on your own computer, and looked after by your AI assistant (Claude Code, Claude Desktop, Cursor, VS Code or any MCP client). Made for the UK.

The home screen: what's coming up, next payday, this week's spending and the rainy-day pot

What it does

  • Remembers the dates. Renewals, bills, subscriptions, warranties, MOT, passport, birthdays and appointments, with reminders in your own calendar.

  • Bills before payday. Lists what goes out before your next pay or pension, and moves payday to the working day before when it falls on a weekend or bank holiday.

  • Shows where the money goes. Import a bank statement (every UK bank app can export one) and see this week or month by category, compared with what's usual for you.

  • Rainy-day planner. Spreads big yearly bills into monthly amounts, then suggests Gentle, Steady or Stretch saving amounts, each checked against your tightest recent month.

  • Spots price rises. Records the old and new price at every renewal, so loyalty penalties are visible.

  • A calm home screen. Large text, plain words, light and dark colours, and a Print button for the fridge.

  • UK bank holidays for England and Wales, Scotland and Northern Ireland, built in.

Related MCP server: SpendPilot

Try it

Ask your assistant things like:

  • "Add my car insurance: £412 a year, renews 3 March."

  • "What's coming up this month?"

  • "Import my bank statement from Downloads."

  • "How much could I put aside for a rainy day?"

  • "Put my renewals in my calendar."

  • "Show me my home screen."

Install in Claude Desktop (easiest)

No technical steps, and nothing else to install: Claude Desktop includes everything it needs.

  1. Install Claude Desktop and sign in.

  2. Download life-admin.mcpb from the latest release.

  3. Double-click it. Claude opens and asks two things:

    • Where to keep your life admin: leave it as it is.

    • Where in the UK do you live? Type England, Wales, Scotland or Northern Ireland.

  4. Click Install. In Claude's Settings → Extensions, check that Life Admin is switched on.

  5. Start a new chat and try: "Show me my home screen."

Helping someone set up? Do steps 1 to 5 with them once; after that they just talk to Claude.

Set up with Claude Code, Cursor or VS Code

Needs Node.js 18 or newer.

npx -y @nkc27/life-admin-mcp init        # creates ~/LifeAdmin and prints the line to connect your assistant
npx -y @nkc27/life-admin-mcp doctor      # checks everything, including a live connection test
npx -y @nkc27/life-admin-mcp dashboard   # opens the home screen in your browser

For Claude Code: claude mcp add --scope user life-admin -- npx -y @nkc27/life-admin-mcp

Also: due prints what's coming up, and ics writes a calendar file. Set LIFE_ADMIN_REGION to Scotland or Northern Ireland for local bank holidays. npm run bundle builds the one-click life-admin.mcpb and checks it by installing it the way Claude Desktop does.

Tools

Area

Tools

Dates and renewals

due_soon, add_item, get_item, update_item, mark_handled, search_items, list_items, delete_item, restore_item

Money

import_bank_file, add_spending, categorise, spending_summary, money_ahead, rainy_day_plan, update_pot

Calendar and screen

export_calendar, bank_holidays, open_home_screen, get_stats

Item types: bill, renewal, subscription, policy, warranty, vehicle, document, income, birthday and reminder.

Agent skill

Tools are only half of it: an assistant also needs to know how to use them well. skill/life-admin/ is a free SKILL.md that teaches it to never invent dates or prices, keep card numbers out, ask before importing or deleting, never promise a reminder it can't send, and treat pushy "pay now" emails as possible scams. Copy the folder into your assistant's skills directory, or build a zip with npm run package-skill.

A test checks the skill against the live server, so every tool and argument it names really exists. npm run eval:skill runs behaviour scenarios in real Claude sessions (needs the claude CLI signed in).

Private and careful by design

  • Stays on your computer. Plain markdown and CSV files in ~/LifeAdmin that open in any editor or Excel. The server never uses the internet, and the home screen only answers this computer.

  • No full card numbers. Card numbers are refused or masked to the last four digits.

  • Never invents figures. Every amount comes from your own records or what you typed. Impossible dates are flagged, never quietly changed.

  • Budgeting help, not financial advice. The planner does sums on your own figures and never recommends financial products. It points to free help: MoneyHelper, and StepChange for debt.

  • Reminders you can trust. An AI assistant can't nudge you by itself, so reminders go into your own calendar. Repeats match the app's own date logic exactly, and month ends stay right (31 Jan → 28 Feb → 31 Mar).

  • Safe to undo. Deleted items go to a trash folder and can be restored. Bank imports preview before saving and skip duplicates.

Development

npm test         # build, then unit, CLI, calendar, dashboard and end-to-end MCP tests
npm run format   # prettier

LIFE_ADMIN_TODAY=YYYY-MM-DD pretends it's another day (for tests and demos). npx tsx scripts/make-demo-money.ts rebuilds the fictional demo spending.

Bank holiday dates come from gov.uk: contains public sector information licensed under the Open Government Licence v3.0.

Licence

MIT

Available Tools

20 tools
add_itemAdd itemA

Start tracking something: a bill, renewal, subscription, warranty, policy, vehicle or document. Use only facts the user gave you; leave out a due date or cost rather than guessing. Refuses an exact duplicate title (use update_item instead) and anything that looks like a full card number.

Inputs: type (required), title (required), due, ref, +8 more.

add_spendingAdd spendingA

Record one payment or refund the person tells you about ("I spent £42 on a meal out"). The category is worked out from the description unless given. Amounts are always positive; set money_in for refunds or money received. Categories: bills (Bills & energy), groceries (Groceries), shopping (Shopping), going-out (Eating & going out), transport (Transport), tax (Tax), subscriptions (Subscriptions), savings (Savings), income (Income), transfers (Transfers), other (Other).

Inputs: amount (required), description (required), date, category, +1 more.

bank_holidaysBank holidaysA
Read-onlyIdempotent

Upcoming UK bank holidays (official gov.uk list, bundled) for England and Wales, Scotland or Northern Ireland. Useful because pay due on a bank holiday or weekend usually arrives the working day before, and payments due then are usually taken the next working day.

Inputs: days, region.

categoriseSort spending into a categoryA

Put every transaction whose description contains these words (whole words, any case) into a category, and by default remember it so future imports are sorted the same way. Use after an import lists unsorted shops. Categories: bills (Bills & energy), groceries (Groceries), shopping (Shopping), going-out (Eating & going out), transport (Transport), tax (Tax), subscriptions (Subscriptions), savings (Savings), income (Income), transfers (Transfers), other (Other).

Inputs: match (required), category (required), remember.

delete_itemDelete itemA
Destructive

Stop tracking an item. It moves to the trash and can be brought back with restore_item. Confirm with the user first.

Inputs: item (required).

due_soonDue soonA
Read-onlyIdempotent

What needs attention: overdue items, items due within the next days days, and items further out whose reminder window has already opened (e.g. a passport with a 180-day reminder). Sorted by due date, with today's date stated. This is the main 'what's coming up?' tool.

Inputs: days, type.

export_calendarExport to calendarA
Idempotent

Write every item that has a due date to an .ics file the user can import into Apple Calendar, Google Calendar or Outlook. Each item becomes an all-day event with a 9am reminder when its reminder window opens and another on the day; repeating items repeat in the calendar. After changes, export again and import into the same calendar to update the events. Provider and cost are included unless minimal is true; references and notes never are. Calendars often sync to a cloud account, so tell the user that.

Inputs: minimal.

get_itemGet itemA
Read-onlyIdempotent

Full details of one item by title: provider, cost, due date with days left and when reminders start, reference, and its notes and history.

Inputs: item (required).

get_statsFolder statsA
Read-onlyIdempotent

Where the life-admin folder lives and what it holds: item counts by type, how many are overdue and how many are due in the next 30 days. Call once at the start of a conversation to orient.

Inputs: no named parameters.

import_bank_fileImport bank statementA

Read a bank statement exported as CSV (every UK bank app can export one) and add its transactions to the person's spending records, sorted into categories. Always run first with confirm false to show a preview, then again with confirm true once the person agrees. Already-imported lines are skipped, so overlapping statements are safe. The file stays on this computer.

Inputs: path (required), confirm.

list_itemsList itemsB
Read-onlyIdempotent

List tracked items, optionally filtered by type, sorted by due date (undated items last).

Inputs: type, limit.

mark_handledMark handledA

Record that the user has dealt with an item (renewed, paid, switched, replaced). Logs it in the item's history and moves the due date on: repeating items roll forward by their period (keeping month-end dates right), next_due sets a date explicitly, and a one-off item's due date is cleared. Pass new_cost when the price changed; the old and new prices are logged.

Inputs: item (required), note, new_cost, next_due.

money_aheadMoney aheadA
Read-onlyIdempotent

Payments due between today and the next payday (from income items, moved to the working day before if payday falls on a weekend or bank holiday), with their total. Given the person's current balance, says roughly what is left until payday. Never guess the balance: ask for it.

Inputs: days, balance.

open_home_screenOpen home screenA
Read-onlyIdempotent

Open the person's home screen in their web browser: what's coming up, the next payday and the bills before it, this week's spending and the rainy-day pot, in large, calm print with a Print button. It runs only on this computer, and stays available while this assistant session is open.

Inputs: no named parameters.

rainy_day_planRainy-day planA
Read-onlyIdempotent

Work out how much the person could put aside, from their own income items and spending records: big yearly bills smoothed into monthly set-asides, then Gentle, Steady and Stretch options, each with a risk check against their tightest recent month and time to a £1,000 pot and to three months of essentials. Flags varying income, rising spending, big bills due soon and signs of borrowing. Arithmetic only: never recommend financial products, accounts or investments.

Inputs: no named parameters.

restore_itemRestore itemB

Bring back the most recently deleted item with this title.

Inputs: item (required).

search_itemsSearch itemsA
Read-onlyIdempotent

Find items whose title, provider, tags or notes contain any of the words in the query, best matches first. Use before add_item to avoid duplicates, and for questions like 'where's the boiler warranty?'.

Inputs: query (required), type, limit.

spending_summarySpending summaryA
Read-onlyIdempotent

What was spent this week or month by category, compared with what's usual for the person (the average of up to four earlier periods), plus money in, money saved and the biggest shops. Weeks run Monday to Sunday. offset 1 means last week/month.

Inputs: offset, period.

update_itemUpdate itemA

Change fields on an existing item; anything you leave out stays as it is. clear removes a field. add_note appends a dated line to the item's history. For a renewal or payment that has been dealt with, use mark_handled instead so the due date moves on.

Inputs: item (required), due, ref, cost, +10 more.

update_potUpdate rainy-day potA

Record what is in the rainy-day pot: set the amount saved, add to it (or take from it with a negative amount), or set a goal. Only use figures the person gave you.

Inputs: add, saved, target.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 20 tools

    Disambiguation4/5

    Most tools target clearly distinct purposes: item CRUD (add/update/delete/restore), retrieval (list/get/search/get_stats/due_soon), and a separate money sub-domain (add_spending, import_bank_file, categorise, spending_summary, money_ahead, rainy_day_plan, update_pot). The main soft spot is the retrieval cluster in the item domain, where list_items (sorted by due date), due_soon (overdue/reminder windows), and search_items can all return overlapping item sets. Descriptions do disambiguate ('main what's coming up tool', 'use before add_item to avoid duplicates'), so real confusion is limited.

    Naming Consistency4/5

    The dominant pattern is snake_case verb_noun: delete_item, restore_item, list_items, get_item, search_items, add_item, update_item, export_calendar, import_bank_file, add_spending, update_pot, open_home_screen. Deviations are feature/entity-style names (due_soon, spending_summary, money_ahead, rainy_day_plan, bank_holidays, get_stats) but they are all snake_case and semantically transparent, not chaotic.

    Tool Count3/5

    Twenty tools is on the heavy side for a single server and reflects that it bundles two fairly large domains (tracked items plus personal spending/planning) with some presentation extras (export_calendar, bank_holidays, open_home_screen). Each tool plausibly earns its place, but the surface is broad enough that an agent must sort through many similarly-scoped read tools. Splitting items vs. money would likely be cleaner.

    Completeness4/5

    Item lifecycle is well covered: create, read (get/list/search/stats/due), update, mark handled with roll-forward, delete, restore, and calendar export. Spending has add/import/categorise/summarise and pot tracking, so the main gap is the absence of edit or delete for individual spending records (a mistyped or mis-imported transaction can only be re-categorised, not removed). Minor gaps otherwise, with no major dead ends for the core workflows.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables personal finance management through natural language, including tracking income/expenses, categories, loans, subscriptions, budgets, and AI-powered insights, all backed by a local SQLite database.
      1
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables households and small teams to monitor bills and subscriptions, receive evidence-backed saving proposals, and execute actions only after a signed, scope-capped mandate, with every decision and refusal logged in an auditable ledger.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables natural-language access to personal finance data, including consolidated balances, monthly overviews, transaction search, credit card invoices, recurring bills, budgets, category/tag reports, cash flow forecasts, and Open Finance status, with optional read/write tools.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables users to turn household paperwork into answers about upcoming deadlines, warranties, and plain-language explanations, and to draft related messages such as payment extension requests.
      5 npm
      MIT