New sign-ups are on hold for now. So many people have joined Tax App's free plan that we have paused new sign-ups while we make room. Existing accounts work as normal. Contact us for more information.
Guide
Asking an AI app about your own records
If you use an AI app such as Claude or ChatGPT, you can let it read your Tax App records and answer questions about them. An owner of your organisation switches AI connectors on and decides whether connected apps may also add and change records. Each member then connects their own AI app. A connected app never deletes anything, and an owner can remove it at any time.
The AI app works through your own Tax App login. It never sees your password and can see only what you can see yourself.
What you can ask
Ask in your own words, as you would ask someone with your records in front of them. For example:
- "What is my estimated tax for this year?"
- "Which expenses did I record for the rental in March?"
- "Add a $120 plumber bill for 12 Smith Street."
The AI app looks up the records it needs and answers from them. The figures it reads are the ones Tax App shows you, but the answer is written by the AI, which can misread a figure. Check anything important in Tax App before you rely on it.
Which apps work
The following apps can connect:
- Claude: on the web, in the desktop app, and in the phone apps
- ChatGPT: on the web, on a paid plan
- Grok: on the web and in the phone apps
- VS Code, with GitHub Copilot
- Cursor
- Claude Code
Tax App accepts connections from these apps and from apps that run on your own computer. It refuses any other website. The connection uses the Model Context Protocol (MCP), an open standard for connecting AI apps to other services.
Switching AI connectors on
AI connectors are off in every organisation until an owner turns them on. To do so, the owner opens Settings, then AI connectors, and chooses one of three levels:
- Off: no AI app can reach the organisation.
- Read only: AI apps can read records and reports.
- Read, add and change records: AI apps can also add and change income, expenses, contacts, rental properties, tenancies, expense accounts, contact types, the savings plan, and scheduled reports.
Any member of the organisation can then connect their own AI app. The app may do what the owner chose, but never more than that member's role allows. A read-only member's AI app can only read.
The address to give it
Every app asks for the same address:
https://mcp.taxapp.nz/mcp
Copy it exactly, including /mcp at the end, and paste it into your AI app. It is not a web page, and opening it in a browser shows nothing.
How to connect
Find your app below. Each one finishes in the same way: a Tax App sign-in page opens, and you choose what the AI app may see.
Claude
Add the connector once, in Claude on the web or in the desktop app. It then appears in Claude's phone apps the next time you sign in to them.
- Open Customize, then Connectors.
- Choose Add, then Add custom connector.
-
Enter the name
taxappand the addresshttps://mcp.taxapp.nz/mcp, then choose Continue. - Keep the sign-in settings that Claude suggests, and choose Add.
- When Claude asks you to sign in, sign in to Tax App on the page that opens.
To use it in a chat, choose the + button at the bottom left, then Connectors, and turn taxapp on.
Claude's free plan allows one custom connector. On a Team or Enterprise plan, an owner of your Claude organisation must first add the connector under Organization settings, then Connectors. You then connect to it from your own Connectors list.
ChatGPT
ChatGPT connects to services outside its own directory through developer mode, which is available on the web on paid plans.
- Open Settings, then Security and login, and turn on Developer mode.
- Go to Plugins and choose the + button.
-
Enter the name
taxappand the addresshttps://mcp.taxapp.nz/mcp. - Set Authentication to "OAuth" (the sign-in option), and create the connection.
- When ChatGPT asks you to sign in, sign in to Tax App on the page that opens.
To use it in a chat, choose Developer mode from the + menu, then pick taxapp.
Grok
- Open Connectors (on the web, grok.com/connectors).
- Choose New Connector, then Custom.
-
Enter the name
taxappand the addresshttps://mcp.taxapp.nz/mcp, and add it. - When Grok asks you to sign in, sign in to Tax App on the page that opens.
VS Code
The connection works with GitHub Copilot's chat in VS Code. On a computer with VS Code installed, the following link opens VS Code and offers to install the Tax App connection:
Choose Install. When VS Code asks whether taxapp may sign in, allow it, and sign in to Tax App on the page that opens. Then open the Chat view, choose Agent, and ask your question.
If the link does nothing, add the connection manually:
- Open the Command Palette and run MCP: Add Server.
- Choose HTTP.
-
Enter the address
https://mcp.taxapp.nz/mcpand the nametaxapp. - When VS Code asks you to sign in, sign in to Tax App on the page that opens.
Cursor
On a computer with Cursor installed, the following link opens Cursor and offers to install the Tax App connection:
Confirm the installation. When Cursor asks you to sign in, sign in to Tax App on the page that opens. Then ask your question in Cursor's chat.
If the link does nothing, add the following to the file mcp.json in the .cursor folder of your home folder, then sign in from Cursor's settings:
{"mcpServers":{"taxapp":{"url":"https://mcp.taxapp.nz/mcp"}}}
If the file already has an mcpServers section, add only the Tax App entry inside it, and put a comma after the entry just before it:
"taxapp": {"url":"https://mcp.taxapp.nz/mcp"}
Claude Code
Run this in your terminal:
claude mcp add --transport http taxapp https://mcp.taxapp.nz/mcp
The command is a single line, with two hyphens before transport. Then start Claude Code, type /mcp, choose taxapp, and choose Authenticate. Sign in to Tax App on the page that opens.
What happens when you connect
Every app sends you to the same Tax App page, at app.taxapp.nz, to finish connecting. Nothing is shared until you approve the connection there.
- Sign in with your usual Tax App login.
- Check that the page names the app you are using. If it names a different one, choose Don't allow. An app that runs on your own computer, such as Claude Code, may appear as "An app on this computer".
- Tick each organisation the AI app may see. It sees nothing in an organisation you leave unticked.
- For each organisation, the page says what the AI app will be able to do, as the owner chose: read only, or read, add and change records. You cannot tick an organisation where AI connectors are off, unless you own it. If you own it, ticking it switches AI connectors on at the level you choose.
- Choose Allow. A web app such as Claude or ChatGPT takes you back automatically. With an app on your computer, close the tab and go back to the app.
What it can do
In the organisations you ticked, the AI app can read:
- income and expense records, with their contacts, properties, and expense accounts
- the tax year overview, the tax summary, and your estimated tax
- profit and loss, and the rental report for each property
- contacts, without their Inland Revenue (IRD) numbers or bank account numbers
- rental properties, with their owners and tenancies
- the bank inbox, and the progress of reconciliation
Where the organisation allows it, the AI app can also add and change:
- income records, short stays and their refunds included: it can add a stay, change it, or cancel and reinstate its booking
- expense records
- contacts, including a person's PAYE salary, a contractor's ACC classifications and an owner's or partnership's GST registration
- rental properties, including their owners' shares and who is registered for GST for their short stays
- tenancies, for example to record a rent increase or a lodged bond
- expense accounts and contact types
- the savings plan
- scheduled reports (which only owners can set up), including sending one straight away
The AI app passes on only what you tell it: dates, amounts, who paid, and what the payment was for. Tax App calculates GST, KiwiSaver, the ACC levy, tax, and every total itself, as it does when you use its own forms.
The AI app chooses contacts, rental properties, expense accounts, and income types from those you already have. When it is unsure which one you mean, it shows you the closest matches and asks. Every record it adds names a contact, as yours do, and appears in Tax App like any other record. Sending the same record twice does not create a duplicate, unless the AI app says it means to add a second record.
Every change it makes is recorded in your organisation's audit trail, marked as made through the AI connector. Records it adds are not reconciled when they are created. Your next reconciliation treats them like any other record.
Most of these apps ask for your confirmation before the AI app adds or changes anything. Read what it proposes to do before you agree.
What it cannot do
- It cannot delete anything.
- It cannot change members, organisation details such as modules and tax rates, or connections to other services.
- It cannot reconcile bank statements or change a match.
- It cannot see an organisation you did not tick, or anything your own role cannot see.
- It cannot file a return with IRD.
Control and privacy
You approve each organisation yourself, on a Tax App page. The AI app then acts as you, with your role, and never beyond what the owner allowed. If you leave an organisation, the AI app loses access to it as well.
Under Settings, then AI connectors, an owner sees every AI app connected to the organisation, whoever connected it, and can remove any of them. Switching AI connectors off removes them all at once. A removed AI app loses its access, and nothing in your records changes.
Changing your password ends every AI connection you made, in every organisation.
Whatever you share goes to the company behind the AI app you chose, such as Anthropic for Claude or OpenAI for ChatGPT. That company handles it under its own terms with you and may store it outside New Zealand. Your records in Tax App stay where they are. See the privacy policy for details.
Where to go next
- How income tax is calculated: the working behind the estimated tax your AI app reads.
- Privacy policy: what happens to records you share with an AI app.