ezbookkeeping
by mayswind
Personal DevelopmentBrief
ezBookkeeping is a lightweight, self-hosted personal finance app.
Description
What This Skill Does
Connects to a self-hosted ezBookkeeping instance via its API to manage personal finance data. Supports recording transactions, querying history, and retrieving accounts, categories, tags, and exchange rates.
Lets you interact with your self-hosted finance data through an agent without opening the ezBookkeeping web UI.
When to Use It
- Log a new expense after a purchase
- Check recent transactions for a specific account
- Look up available spending categories before categorizing an entry
- Retrieve current exchange rates for a foreign transaction
- Query tags to find transactions in a custom group
Example Workflow
User asks: 'Add a $45 grocery expense to my checking account'
- 1
Retrieve available accounts to confirm the checking account ID
- 2
Retrieve categories to find the groceries category ID
- 3
Call the transaction creation command with amount, account, and category
- 4
Confirm the transaction was recorded successfully
New expense transaction of $45 recorded under Groceries for the checking account
Requirements
- EBKTOOL_SERVER_BASEURL environment variable (your ezBookkeeping server URL)
- EBKTOOL_TOKEN environment variable (API token from your ezBookkeeping instance)
- Self-hosted ezBookkeeping server
Installation
clawhub install mayswind/ezbookkeepingRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.