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:

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:

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:

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.

  1. Open Customize, then Connectors.
  2. Choose Add, then Add custom connector.
  3. Enter the name taxapp and the address https://mcp.taxapp.nz/mcp, then choose Continue.
  4. Keep the sign-in settings that Claude suggests, and choose Add.
  5. 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.

  1. Open Settings, then Security and login, and turn on Developer mode.
  2. Go to Plugins and choose the + button.
  3. Enter the name taxapp and the address https://mcp.taxapp.nz/mcp.
  4. Set Authentication to "OAuth" (the sign-in option), and create the connection.
  5. 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

  1. Open Connectors (on the web, grok.com/connectors).
  2. Choose New Connector, then Custom.
  3. Enter the name taxapp and the address https://mcp.taxapp.nz/mcp, and add it.
  4. 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:

Add to VS Code

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:

  1. Open the Command Palette and run MCP: Add Server.
  2. Choose HTTP.
  3. Enter the address https://mcp.taxapp.nz/mcp and the name taxapp.
  4. 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:

Add to Cursor

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.

  1. Sign in with your usual Tax App login.
  2. 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".
  3. Tick each organisation the AI app may see. It sees nothing in an organisation you leave unticked.
  4. 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.
  5. 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:

Where the organisation allows it, the AI app can also add and change:

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

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

Start free Contact us