Finance Assistant skill
A Claude Code skill for personal finance and tax by seven countries rules with statement import and FIRE, all local.
- 53 ★ on the repository
- Last commit
Broad access
Why this level
- The skill reads bank statements and keeps financial and tax data in a local database.
- The conversation goes to the Anthropic API by default and optional features call rate services and bank sync.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/finance-assistantDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The skill reads bank statements and keeps financial and tax data in a local database.
- The conversation goes to the Anthropic API by default and optional features call rate services and bank sync.
This is third-party code. Review the repository files before installing.
What it does
Finance Assistant runs locally through Claude Code and applies real tax statute to your numbers: deterministic Python does the maths and the model only talks to you. The skill imports bank statements in 14 formats, and an unrecognized file such as a scanned PDF or a screenshot is read by the model itself, after which the data goes through sanitizing, deduplication and confirmation. Data lives in a local SQLite database with an encrypted backup and an audit log of every change, and a total wipe command deletes it all. In examples the skill answers questions such as "what is my FIRE confidence" by running 10,000 simulations, and compares taxes for an employee and a freelancer on the same income. Tax rules live in per-country plugins: Germany, the UK, the US, France, the Netherlands, Poland and Ireland, validated against 39 official tax-authority test cases.
Who it is for. People who want precise answers about their own money without cloud services or handing over a bank login and who work in Claude Code.
Good fit when
- You want the probability of reaching an early retirement goal at given contributions.
- Income is the same and you must compare tax as an employee and as a freelancer.
- Statements from different banks must be collected into one local database without a cloud upload.
- You need a weekly digest of spending and subscriptions from imported statements.
Not a fit when
- You need a licensed advisor: the skill does not replace a professional, and filing decisions need a tax professional check.
- Your country is outside the seven: you can add it with the scaffold generator but no ready rules exist.
- You need zero conversation egress: by default Claude Code sends the dialogue to the Anthropic API.
Example request
What is the probability that I retire by 2042 with my current savings and a 200 dollar monthly contribution? Show the distribution of results.Limitations
The skill is software, not a licensed advisor: confirm calculations for tax filing decisions with a professional or the tax authority. Data at rest stays on your disk, but by default Claude Code sends the conversation itself to the Anthropic API. For nothing to leave the machine you need a local mode through claude-code-router and Ollama. Optional features reach the network: exchange rates, stock and crypto prices, GoCardless sync. It needs Python 3.10 or newer and a clone with submodules. The claude.ai variant has fewer features. The repository states a CC BY 4.0 license that GitHub did not recognize.
How to disable. Delete the `~/.claude/skills/finance-assistant` folder. Data lives in the project `.finance/` directory: the total wipe command in the skill removes it, and encrypted backups are removed separately. After encryption say "decrypt my data" before using the skill again.
FAQ
How do I install Finance Assistant?
Run `curl -fsSL https://raw.githubusercontent.com/googlarz/finance-assistant/main/install.sh | bash`: the script clones the repository, installs dependencies and runs a health check. By hand: `git clone --recurse-submodules` into `~/.claude/skills/finance-assistant` and `pip install -r requirements.txt`.
How can I try it without my data?
Run `python3 ~/.claude/skills/finance-assistant/skill.py --demo` and the skill shows its work on sample data. A live conversation demo is on the project site.
Which countries are supported?
Germany, the UK, the US, France, the Netherlands, Poland and Ireland. Rules are validated against 39 official tax-authority test cases. A scaffold generator exists for a new country and adding one takes about an evening.
Does my data go to the cloud?
Data is stored locally in `.finance/` with no sync or telemetry. Only optional features make network calls, and the conversation itself goes to the Anthropic API by default. A fully local mode needs claude-code-router and Ollama.
Is there an MCP server?
Yes, optional: `pip install ".[mcp]"` adds a server with read tools and a few write tools that run dry first. It needs Python 3.10 or newer.
Discussion
No questions or reviews yet.
Related
SkillsA personal family office in the terminal: typed portfolio calculators, a local ledger and agents for Claude Code and Codex.
A set of skills for French bureaucracy: accounting, tax, invoicing, notarial work, audit and condominium management
Twenty skills on Swedish bookkeeping and tax for Claude Code: VAT, payroll, year-end closing, SIE and SRU files.
16 Claude Code commands for Russian sole proprietors: invoices, acts, contracts, taxes and contributions, with data kept in local files
Anthropic's plugin marketplace for finance teams: 10 agents plus skills and MCP connectors for DCF and LBO models, earnings, reconciliation and KYC
A Claude Code plugin for Japanese annual tax returns: from bookkeeping to filling in the filing portal, for sole proprietors and employees, in Japanese
README in short
By the author account the skill applies real tax statute to your numbers and runs locally, backing its output with 1,630 tests and 39 official cases. It shows live conversations, installation for Claude Code and Cowork, countries, privacy and an MCP server.
README badge
Original SKILL.md
--- name: finance-assistant description: > Personal finance assistant for budgeting, savings goals, investment tracking, debt optimization, tax preparation, insurance review, net worth tracking, and financial scenario modeling. Supports multi-currency, bank statement import (CSV/MT940/OFX), and locale-based tax rules. Use for any personal finance question: budget planning, expense tracking, portfolio allocation, FIRE calculations, debt payoff strategies, mortgage comparisons, tax deductions, insurance coverage, retirement planning, and life events with financial impact such as marriage, buying a house, changing jobs, having a baby, or going freelance. triggers: - budget - spending - savings - tax - investments - debt - net worth - FIRE - retire - salary - financial health - money - income - expenses --- # Finance Assistant Finance Assistant is a friendly but expert financial adviser — like having a smart friend who happens to know a lot about personal finance. Not a dashboard, not a report generator: a thinking partner who knows your numbers, remembers your situation, and gives you a straight opinion. ## 1. Mission and Boundaries - Help the user keep more money, grow it smarter, and move to the next best action with less confusion. - Quantify answers with the user's real numbers whenever possible. - Use local repo helpers and bundled rules instead of improvising financial math from memory. - Match the user's language: respond in the language they use. - Do not present this as legally binding financial advice. - When the case exceeds the repo's safe scope, hand off with a structured brief instead of bluffing. ## 2. Voice and Tone — this is the most important section You sound like a knowledgeable friend who happens to be a financial expert, not like software. Every response should feel like it came from a person who knows the user's situation and genuinely wants to help.