I filed my own taxes with Claude in one sitting. Last year it took me seven hours.

TL;DR: My tax return is the messy kind: foreign freelance income, a bit of F&O, capital gains, and a share buyback I barely understood. Last year it took me seven hours and I still hit submit with a knot in my stomach. This year I did it with Claude Code in one sitting, reconciled every rupee to source, and caught two errors that would have triggered notices. Claude does the brain work; I do the authenticated clicks. It never logs into my tax account. Here is the whole playbook.

Every year around this time, a quiet dread sets in.

My return is not the simple one. There is foreign consulting income paid by clients who have never heard of Indian TDS, a small F&O loss, some short-term capital gains, dividends, and a share buyback that I understood just well enough to be nervous about. That combination forces ITR-3, the heaviest individual form, with around 24 schedules. Last year I spent about seven hours on it, guessed at half the boxes, and submitted with my stomach in a knot, half-expecting a mismatch notice.

This year I opened Claude Code, pointed it at my documents, and filed a clean, fully reconciled, fully paid return in one sitting. And the surprise was not that it was fast. It was that, for the first time, I actually understood my own taxes.

The one rule that makes it safe

Before the how, the principle it all rests on:

Claude does the brain work. I do the two clicks that matter.

Claude parses the files, reconciles the income, computes the tax to the rupee, decides the form, maps every number to the right schedule, and catches the errors. I download the files, pay the challan, and hit submit plus e-verify. Claude never logs into the tax portal. It never submits a return. Those steps need my PAN login and my Aadhaar OTP, and they stay mine. That split is not a limitation. It is exactly what makes handing your taxes to an AI sane instead of terrifying.

The workflow, start to finish

Feed it three files

Log into the income-tax portal and download three things:

1. Last year's filed ITR (JSON). This tells Claude your form, your regime, and your history.
2. This year's pre-filled JSON, the portal's auto-populated data (TDS, dividends, interest from AIS).
3. Your AIS and TIS, the department's master list of everything it can see about you.

Drop them in a folder. That is your entire "gathering" job. The pre-filled JSON is not meant to be human-readable, it is built for the offline utility, and it does not matter. Claude reads the raw JSON directly and pulls out every figure.

Reconcile against your bank statement

This is the step that turns "probably right" into "verified," and it is where the dread starts to lift.

I dropped in my full-year bank statement, over 1,100 transactions. Claude summed my foreign-income credits and matched them to the rupee against my remittance dashboard. It confirmed my interest income matched the AIS exactly. And then it did the thing I could never be bothered to do properly: it separated real income from noise. It correctly worked out that more than ₹8 lakh of UPI credits were rent splits from flatmates and transfers from family, not taxable income, and that money coming back from my trading account was my own cash returning, not earnings.

Ten minutes of that replaced hours of me squinting at a statement, whispering "wait, is this income?"

Build the computation

With the numbers locked, Claude produced the full tax computation: which income goes in which schedule, the 44ADA presumptive math, the F&O loss set-off, the capital-gains treatment, the exact tax, and the interest owed for not paying advance tax. When we reached the portal, its computation matched the portal's own, to the rupee. Independent confirmation that it was right.

Fill the form together, schedule by schedule

I opened the online ITR-3, and Claude walked me through every single schedule: exactly what to type in each box, what to leave at zero, and why. When the form threw one of its famously cryptic validation errors, I screenshotted it and had the plain-English fix in seconds.

Pay, submit, e-verify

Claude computed the exact self-assessment tax. I paid the challan, entered it back into the form, and it confirmed the balance had hit ₹0. Then submit, Aadhaar OTP, done and verified. The finish line most people forget: an unverified return counts as not filed.

The two errors it caught

This is the real value, and it is something no "how to file your ITR" listicle can ever give you. Because Claude was reasoning over my actual data, it caught two mistakes I would have made.

A missing schedule. The portal's schedule-picker did not auto-include the Capital Gains schedule. If I had filed without it, I would have omitted share sales that the department already sees in its own records. That is a guaranteed mismatch notice. Claude cross-checked my TIS, saw the sale value sitting there, and stopped me: you are missing this schedule, add it.

A double-counted buyback. I had a share buyback. Under the rules that changed in late 2024, buyback proceeds are now treated as a deemed dividend, taxed as dividend, not as a capital gain. My broker's report and the department's AIS both listed it, but in different places and under different labels. It would have been dead easy to count it twice, once as dividend and once as capital gain, and quietly overpay. Claude traced it across my bank statement, my broker report, and my AIS, worked out that the suspiciously large "dividend" from one company was actually the buyback, and corrected the capital-gains figure so it was counted exactly once.

Neither of those is in any guide. Both came from an AI reading my specific documents and thinking about them.

Tips worth stealing

1. Give it your bank statement, not just the tax docs. The reconciliation against real bank credits is what turns a guess into a verified number, and it is how you correctly exclude the non-income: reimbursements, family transfers, your own cash moving back from a broker.
2. Let the AIS and TIS be the referee. Whatever you report should match what the department already sees. The cleanest position of all was my foreign income: invisible to the department because there is no Indian TDS on foreign clients, so declaring it meant I was voluntarily reporting more than they could see. Over-transparent, nothing hidden.
3. Screenshot every validation error. The portal's messages are riddles ("fill particulars in Sl. No 6 of Part-A BS"). Paste the screenshot, get the fix and the exact value.
4. Know your form before you start. Trading plus capital gains forces ITR-3, not the simpler ITR-4. Claude figured this out from last year's return in seconds. Do not let the portal's wizard guess it for you.
5. Pay the self-assessment tax before you submit. File with a balance owing and you earn a demand notice plus running interest. Pay first, enter the challan, confirm the balance is ₹0, then submit.

The honest caveats

Claude is not a chartered accountant, and neither am I. For a return with foreign income, trading, and capital gains, a CA's thirty-minute review is cheap insurance. Claude got the structure and the numbers right and verified them against primary sources, but it is a tool that makes you competent, not a licensed substitute.

AI can misread or hallucinate. That is exactly why the reconciliation matters. Every figure was cross-checked against bank, AIS, and broker reports, not taken on faith. If a number cannot be traced to a source, it does not go in the return.

Your data stays yours. Everything ran on local files on my machine. Nothing was uploaded anywhere except what I typed into the chat. Your PAN, your account numbers, your statements: keep them in local, private files.

What actually changed

Last year: seven hours, a lot of guessing, zero confidence, and I still did not understand my own return.

This year: one sitting, every number reconciled to source, two notice-triggering errors caught, tax paid, filed, verified. And for the first time, I understand what is actually in my ITR. That last part is the real win. When you understand your return, you cannot be bluffed by a bad CA, you catch your own mistakes, and next year takes twenty minutes instead of seven hours.

The tool did not replace me. It made me the expert on my own taxes. That is the whole difference between "AI did my taxes," which should scare you, and "AI taught me to do my taxes right," which is the version actually worth having.

Not tax advice. Verify every figure against primary sources, and get a CA to glance at anything complex. But do it with your own eyes open, because the point was never speed. It was finally understanding the thing I used to just pay someone to hide from me.