A SKILL FOR CLAUDE AND OPENAI CODEX · 2026 RULES

Receipts in, net spendable out

Drop one folder of invoices and receipts, answer a few questions about your tax profile, and the SoloTreasury AI Assistant tells you this month's net spendable amount: what you can pay yourself after the income-tax, social-contribution and VAT reserves.

€29 on its own, or €69 together with the SoloTreasury Freelancer Edition sheet. Paid once.

Have only this month's folder? The Assistant is enough. Want the whole year in one place? Take the sheet with it.

✓ The AI reads, a calculator counts ✓ Germany, Spain, France, Netherlands, Cyprus ✓ No subscription

Who it is for, and who it is not for

The Assistant computes the reserves for a fixed set of tax profiles. Outside them, you set your own reserve rate.

It is for you if

  • You are a freelancer in Germany (single Freiberufler), Spain (individual autónomo in Madrid), France (micro-BNC with versement libératoire), the Netherlands (result from other work) or Cyprus (resident self-employed).
  • You own and direct a Cyprus limited company and want this month's safe owner pay.
  • You work in another country and are happy to give your own reserve rate.
  • You already own a SoloTreasury sheet and want the month's documents read for you. The Assistant writes a file for the sheet's "Import from AI Assistant" command.

It is not for you if

  • You want your tax return filed. The Assistant does not file anything.
  • You use the free Claude plan. Skills need a paid plan, Pro or higher, or OpenAI Codex.
  • You own a limited company outside Cyprus.

The Assistant plans what to set aside. It is not tax advice, and your accountant still files your returns.

What it does

One folder per month. The same questions are not asked twice.

  1. Drop one folder

    Put a month of invoices and receipts in one folder. PDFs, photos of receipts and a bank export (CSV) all work.

  2. Answer a few questions

    Claude asks about your tax profile once and saves the answers in the folder. Next month it only asks what changed.

  3. The calculator does the sums

    The AI reads the documents. A small calculator that ships inside the skill computes the reserves with the same 2026 rules as the SoloTreasury sheets, so the result does not depend on what the AI "thinks".

  4. Read the answer

    The report opens with this month's net spendable amount, then shows how it adds up and lists anything that needs your review.

The four files it writes next to your documents

The report

net-spendable-report-<date>.md: the headline figure first, then revenue, expenses, profit, the reserves, the VAT position and the next statutory dates.

A ledger CSV

ledger-<date>.csv: every document as one row, in the column order the SoloTreasury sheet uses. This is the file to share with your accountant.

A JSON file

net-spendable-<date>.json: the same numbers, for your own tools.

A sheet import file

solotreasury-import-<date>.json: for the "Import from AI Assistant" command in both SoloTreasury sheets, the Freelancer Edition and the Cyprus Company Edition.

In the sheet, the import fills only the cells you normally type in and skips invoices and expenses that are already there.

What it is not

  • Not a tax filing. Nothing is sent to a tax office.
  • Not tax advice. It tells you what to keep aside each month. Your accountant confirms what you owe.
  • Not a silent guess. Readings it is unsure about are listed for your review in the report instead of being corrected quietly.
  • Not a replacement for your accountant. Share the ledger with them; it is in the order the SoloTreasury sheet uses.

Try it on the sample folder first

The download includes a sample folder with twelve fake documents of a Berlin freelancer, and the answers to give. Run the Assistant on it and the report should open with:

This month you can safely pay yourself: 2,842.48 EUR

If it does, your installation works and you can point it at your own folder.

What you need, and how to install it

No programming is involved. Step-by-step instructions for each tool come in the download.

You need

  • A paid Claude plan (Pro or higher) with the Claude desktop app or Claude Code, or OpenAI Codex.
  • Python 3.8 or newer on your computer if you use Claude Code or Codex. Nothing else to install. In the Claude app the calculator runs in Claude's own environment.
  • A folder with one month of invoices and receipts.

Claude desktop app

In Settings, open Capabilities and upload the skill file under Skills. Then let Claude work in your documents folder and ask it to run your net spendable.

Claude Code

Copy the skill folder into your personal skills folder (.claude/skills), start Claude Code in your documents folder and ask it to run your net spendable.

OpenAI Codex

Copy the same skill folder into the Codex skills folder (.codex/skills), start Codex in your documents folder and ask the same.

NO SUBSCRIPTION

Two prices, each paid once

AI ASSISTANT

SoloTreasury AI Assistant

€ 29 one-time, VAT included
  • The skill for Claude and OpenAI Codex, with the calculator inside.
  • Profiles for Germany, Spain, France, the Netherlands, Cyprus and Cyprus company owners, or your own reserve rate.
  • Report, ledger CSV, JSON and a sheet import file.
  • Sample folder to check your installation.
  • One business per purchase. Updates by email through version 1.x while the product is supported, including each year's new rates.
SHEET + AI ASSISTANT

SoloTreasury + AI Assistant

€78 € 69 one-time, VAT included
  • Everything in the AI Assistant.
  • The Assistant answers one month at a time. The Freelancer Edition sheet (DE, ES, FR, NL, CY) keeps every month's invoices and expenses in one place, with one click to import each month.
  • Exchange rates fetched automatically from the European Central Bank for 30 currencies, for clients you invoice in USD, GBP or CHF.
  • A clean Excel export for your accountant at year end.
  • €9 less than buying the sheet (€49) and the Assistant (€29) separately.

Already own a SoloTreasury sheet? Buy the AI Assistant on its own for €29. That includes owners of the Cyprus Company Edition: the import file works with the company sheet too.

Secure payment with Lemon Squeezy · Delivered by email after payment · Email support covers installation and the report, not tax advice

Price includes VAT. Lemon Squeezy, our reseller, charges the US-dollar equivalent at the mid-market rate, with no conversion fee of its own. Your bank may add its usual foreign-currency fee.

Questions before you buy

The Assistant is enough if you want one month's safe-to-spend amount from one folder of documents. Take the sheet as well if you want every month kept together, exchange rates filled in for you and one file for your accountant at year end.
Claude, in the desktop app and in Claude Code, on a paid plan (Pro or higher), and OpenAI Codex. It is a skill: a folder of instructions plus a small calculator that these tools load.
No. The AI reads your documents and turns them into ledger rows. The calculator that ships inside the skill does every calculation with the same 2026 rules as the SoloTreasury sheets, so the same documents and answers always give the same result.
It does not guess quietly. Readings it is unsure about are listed for your review in the report, so you can check them before you rely on the figure.
No. On its own the Assistant gives you the report, the ledger CSV and the JSON. If you have a SoloTreasury sheet, the import file brings the month's rows into it with the "Import from AI Assistant" command, in both the Freelancer Edition and the Cyprus Company Edition.
€29, for the AI Assistant on its own. The €69 package includes the Freelancer Edition sheet, so it is for people who do not have it yet. Owners of the Cyprus Company Edition also buy the AI Assistant on its own.
With Claude Code or Codex, yes: Python 3.8 or newer, with nothing else to install. In the Claude desktop app the calculator runs in Claude's own environment.
It is not tax advice and not a tax filing. It tells you what to keep aside each month. Share the ledger CSV with your accountant, who files your returns. Email support at support@solotreasury.com covers installing the Assistant and reading the report, not tax questions.
One business per purchase. Updates of the Assistant through version 1.x are sent by email while the product is supported, including each year's new rates.