Does gestor file my tax returns?

No. gestor computes the returns and prepares a file for the AEAT Sede import. You check the figures and sign in the Sede yourself.

Where is my data stored?

On your computer, in one SQLite file per profile in ~/.gestor.

An autónomo in Spain under the general IRPF or the Beckham regime, and a one-person Sociedad Limitada with service income.

Which AI agents work with gestor?

Claude Code and Codex, through the gestor MCP server. The agent reads your books and returns, saves drafts after your explicit yes, and can fill the form in the AEAT Sede in your browser.

Can I use gestor without an AI agent?

Yes. Clone the repository and run python3 -m gestor. The interface opens at http://127.0.0.1:8765.

Does gestor replace a gestoría?

No. It computes and explains the returns of an autónomo or a one-person SL, and you file them. Each legal source is marked as explicit in the text, interpretation or disputed. For disputed points and full SL bookkeeping, ask a professional.

Is gestor tax advice?

No. It calculates and explains with sources from BOE, AEAT and TGSS. Check every figure before you sign.

How much does gestor cost?

Nothing. It is open source under the MIT license.

Open source · for autónomos and SLs in Spain

A local gestor for autónomos and SLs in Spain

Invoices, expenses, IVA, IRPF, Beckham, RETA and the filing calendar. gestor computes your returns and explains every amount with the law. You file them yourself.

Alpha · not tax advice MIT · free Runs on your computer

Install with your agent Source on GitHub

Start with your agent

Paste this into Claude Code or Codex. The agent installs gestor and guides your first session, one question at a time. It never files, signs or pays.

For Claude Code or Codex

Install gestor from https://github.com/gestor-es/gestor-es and guide my first session. Talk to me in my language.

1. Clone it into ~/gestor-es. gestor needs Python 3.12+: if python3 is older, help me install a newer one and use it below.

2. In ~/gestor-es start the interface so it keeps running after you exit:

nohup python3 -m gestor > gestor.log 2>&1 &

Then give me the link http://127.0.0.1:8765.

3. Connect the gestor MCP server for your program with the command from the README section "Help in the Sede from Claude Code or Codex", run from ~/gestor-es.

4. Tell me to restart you in ~/gestor-es so the server loads (`claude --continue` or `codex resume --last`) and to write "continue". Then follow the gestor server's First session instructions.

Never file, sign or pay anything. Never ask for my Cl@ve PIN, passwords or certificate passphrase.

Later sessions: in Claude Code type /mcp__gestor__start; in Codex write “start gestor”. The agent names the nearest deadline and what it needs.

Without an agent

git clone https://github.com/gestor-es/gestor-es ~/gestor-es
cd ~/gestor-es
python3 -m gestor        # http://127.0.0.1:8765, data in ~/.gestor

What it computes

Every return an autónomo or a one-person SL meets in a year, with its usual deadline. gestor moves deadlines that fall on weekends and national holidays.

303IVA20.04 · 20.07 · 20.10 · 30.01Quarterly IVA return
130IRPF prepayment20.04 · 20.07 · 20.10 · 30.01Autónomo under the general IRPF
111Retenciones20.04 · 20.07 · 20.10 · 20.01Withheld from professionals and salaries you pay
115Rent retenciones20.04 · 20.07 · 20.10 · 20.01Office rent with retención
349EU operations20.04 · 20.07 · 20.10 · 30.01Only in quarters with EU clients or suppliers
202IS prepayment20.04 · 20.10 · 20.12Sociedad Limitada
390IVA, annual30.01Summary of the year's 303
347Third partiesFebruaryOperations over 3 005,06 € per counterparty
100RentaApril–30.06Annual IRPF, estimate
151BeckhamApril–30.06Special regime of art. 93, estimate
200Impuesto sobre Sociedades25.07SL, estimate
RETASocial securitymonthlyCuota of the self-employed

Regional IRPF scales: Comunitat Valenciana, Asturias, Madrid, Cataluña and Andalucía. Other regions use the state scale as an approximation, and the screen says so.

Rules, figures and deadlines behind these returns, with the law quoted: IVA · IRPF · Beckham · RETA · SL · calendar · visas. Knowledge base

How it works

⁰¹local

Runs on your computer. Python 3.12+, standard library only, one SQLite file per profile in ~/.gestor.

⁰²§

Every amount has a § mark that opens its source: the Spanish quote from BOE, AEAT or DGT, a translation and what it means for you.

⁰³MCP

An MCP server lets Claude Code or Codex read your books and returns. It writes drafts only after your explicit “yes”.

⁰⁴Validar

In the AEAT Sede the agent opens the form, imports the file or types the casillas and presses “Validar”. It does not press “Presentar”. You sign.

⁰⁵EN · ES · RU

Interface, legal sources, knowledge base and docs in English, Spanish and Russian.

See it on a fictional profile: the parts of gestor, the path of one invoice and a quarter worked through. How gestor works

Not covered yetBank import, full SL bookkeeping (journal, annual accounts), Verifactu. The Sede import files are not yet validated on the real Sede.

Questions

Does gestor file my tax returns?: No. gestor computes the returns and prepares a file for the AEAT Sede import. You check the figures and sign in the Sede yourself.
Where is my data stored?: On your computer, in one SQLite file per profile in ~/.gestor.
Who is gestor for?: An autónomo in Spain under the general IRPF or the Beckham regime, and a one-person Sociedad Limitada with service income.
Which AI agents work with gestor?: Claude Code and Codex, through the gestor MCP server. The agent reads your books and returns, saves drafts after your explicit yes, and can fill the form in the AEAT Sede in your browser.
Can I use gestor without an AI agent?: Yes. Clone the repository and run python3 -m gestor. The interface opens at http://127.0.0.1:8765.
Does gestor replace a gestoría?: No. It computes and explains the returns of an autónomo or a one-person SL, and you file them. Each legal source is marked as explicit in the text, interpretation or disputed. For disputed points and full SL bookkeeping, ask a professional.
Is gestor tax advice?: No. It calculates and explains with sources from BOE, AEAT and TGSS. Check every figure before you sign.
How much does gestor cost?: Nothing. It is open source under the MIT license.

gestor calculates; you file yourself in the Sede AEAT. Not tax advice. github.com/gestor-es/gestor-es · MIT · Fonts PT Sans, PT Mono, Prata (OFL)