Petty MCP server

Petty

Everything you keep, in its place. Petty is a private record of what you keep and where: cash in a tin, tools in the basement, passports in the safe, the drill you lent out. Each drawer sits in a place, holds items — money, counted things or notes — and is shared only with the people you choose. Everything is encrypted on your device before it is sent.

Try it at petty.kropka.studio — nothing to install, it works in your browser. Or run your own.

What it does

with a note: a passport, a drill, a spare key. Tag items and filter by tag.

• Money, things and notes. Cash in any currency, things counted by the piece, and single items

moves its drawers. Search finds an item by its name, note or tag.

• Drawers in places. Home › Bedroom › Wardrobe › Safe. A drawer lives in a place; moving a room

readers only look. The server enforces this.

• Shared, with roles. A drawer is shared only with the people you pick. Writers add entries;

reversed, not deleted.

• Count, check, never erase. Mark a drawer as checked after a real count. Mistakes are

MCP app can read and update your drawers. It decrypts on your computer; the server still sees only ciphertext. A Claude skill teaches it the good habits (one total per currency, ask before it writes), and the add-on is listed in the MCP Registry as io.github.WawRepo/petty. See docs/agent.md.

• Works with AI apps. Claude Desktop (a one-click add-on), Claude Code, Cursor, VS Code or any

writes drawers from a terminal, scripts or AI agents, with --json and Tab completion. See docs/cli.md.

• A command line. petty signs in through your browser, like gh auth login, then reads and

installs like an app and keeps working without a network.

• Passkey first, works offline. Face ID, Touch ID or Windows Hello opens your vault. It

• English, Polish, German, Spanish and French — the app, its emails and the sign-in pages.

Made for

who may one day need it.

• Cash at home — every tin and envelope in its room, counted and checked. Where Petty started.
• The workshop — the zip ties are in Home › Basement › Workshop, in the desk drawer.
• A trip kitty — one drawer per trip, one item per person; nobody can quietly change what they paid.
• Yearly accounts — a drawer per account, checked once a year, the date kept with it.
• Lent out — who has your drill, and since when.
• The family safe — where the passports, keys and papers are, shared read-only with the people

Documentation

Shortened. The full README is on GitHub.