taxapp.nz
Server Details
Your taxapp.nz records and NZ tax; adds and edits records only if an owner allows. Sign-in required.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- burger-mtbkr/taxapp-mcp
- GitHub Stars
- 0
- ChatGPT
- –
- Claude
- Taxapp.nz
TDQS
Scored across 40 tools
Tools generally map to distinct resource+action pairs, and descriptions clarify report vs record vs list tools. However, with 40 tools, report-family tools such as get_tax_year_overview, get_profit_and_loss, get_tax_summary and get_rental_report, plus type lookups like list_choices vs list_contact_types, require careful reading and leave some selection ambiguity.
Naming is consistently snake_case with a verb_noun pattern throughout: create_*, get_*, list_*, update_*, set_* and send_*. The one longer name, send_scheduled_report_now, still follows the same convention.
At 40 tools, the set is well beyond the 3-15 sweet spot and above the 25+ heavy threshold. The tax/accounting domain is broad, but many CRUD and reporting variants make the surface cumbersome for an agent to navigate.
The set covers create/list/get/update for core records such as contacts, expenses, income, properties, tenancies, expense accounts and scheduled reports, plus substantial reporting and settings. Gaps include no delete/void for several entities and no direct get-by-id for contacts, properties or tenancies, though app-only reconciliation and active/cancel flags mitigate these.
Publisher details
- Operator
- Tax App NZ · Publisher source
- Operator website
- https://taxapp.nz
- Vendor relationship
- Independent
- Documentation
- https://taxapp.nz/guides/ai-assistants/ · Publisher source
- Privacy policy
- Not provided
- Trust center
- Not applicable
- Restrictions
- Required a active subscription to Tax App NZ
Available Tools
40 toolscreate_contactAdd a contactAIdempotentInspect
Adds a contact: a person or business the organisation deals with, such as a new supplier before adding their bill, a tenant before their tenancy, or a property owner before their property. Give a business's name, or a person's first_name and last_name. Check with list_contacts first that they are not already there: a contact already there with the same name is answered instead, and one without the type asked for is refused: add the type to that contact with update_contact instead. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the saved contact with its organisation's name.
Inputs: contact_types (required), name, email, phone, +8 more.
create_contact_typeAdd a contact typeAIdempotentInspect
Adds a contact type of the organisation's own, such as "Body corporate", for contacts none of the existing types describe. Check list_contact_types first: an active type with the same label is answered instead. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the saved type.
Inputs: label (required), is_customer, is_supplier, allow_duplicate, +1 more.
create_expenseAdd an expense recordAIdempotentInspect
Adds one expense record: a bill or cost. It needs the supplier (contact_id, from list_contacts; add a new supplier with create_contact), an expense account (from list_expense_accounts) and, for a rental cost, the property (from list_properties). liable_contact_ids names the contractors or property owners the cost is shared between, which decides whose figures it reduces. Match the expense type with list_choices and the account by its name or IRD line; When the person's words match more than one, or none, show them the closest and ask which they mean; never guess an id. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the saved record with its organisation's name; tell the person what was added and where.
Inputs: amount (required), contact_id (required), expense_date (required), expense_type (required), +7 more.
create_expense_accountAdd an expense accountAIdempotentInspect
Adds an expense account: a category expenses are filed under, such as "Pest control". Check list_expense_accounts first: an active account with the same name is answered instead. Tag it with the IRD return line it feeds (list_choices lists them as irdExpenseLines) so the year's return totals it. When the organisation is connected to Xero the account is sent there too. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the saved account.
Inputs: name (required), code, ird_line, allow_duplicate, +1 more.
create_incomeAdd an income recordAIdempotentInspect
Adds one income record: money the organisation received. Commission income names the contractor who earned it (contractor_contact_id) and the business that paid it (contact_id). Rent and tenant reimbursements name the tenant who paid (contact_id) and the tenancy or property; a tenant reimbursement can also name the rental bill it pays back (reimbursed_expense_id, from list_expenses). Match the income type with list_choices, and look every id up first with list_contacts, list_properties and list_expenses; When the person's words match more than one, or none, show them the closest and ask which they mean; never guess an id. Add a missing payer with create_contact. A short stay (income type shortStay) names its booking platform as contact_id (a booking-platform contact such as Airbnb, or Direct bookings) and its property, with paid as the payout that reached the bank and the platform's fees and flat-rate GST credit as its statement shows them; a refund (shortStayRefund) names the booking it gives back and how it went back. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the saved record with its organisation's name; tell the person what was added and where. Send only the amount received: taxapp works out GST, KiwiSaver, the ACC levy, income tax and take-home from it.
Inputs: paid (required), contact_id (required), income_date (required), income_type (required), +16 more.
create_propertyAdd a rental propertyAIdempotentInspect
Adds a rental property: what it is called and where it is, and who owns what share of it. Rental income and expenses are split between the owners by their shares in the reports, so ask the person who owns it and in what shares. Each owner is a contact of type property-owner, from list_contacts; add a new owner with create_contact first. Check list_properties first that it is not already there: a property matching every part given (label, address) is answered instead. Needs the rental module switched on. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the saved property with its organisation's name; add its tenancies with create_tenancy.
Inputs: label, owners, address, allow_duplicate, +1 more.
create_scheduled_reportSchedule a reportAInspect
Sets up a report to be emailed to a contact regularly, or once. The report comes from list_scheduled_report_types, the recipient and anyone copied from list_contacts (each needs an email address). Confirm the report, recipient and timing with the person before setting it up: it emails someone outside taxapp. Only an owner of the organisation can see and set up scheduled reports. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the saved schedule with the date it first goes.
Inputs: name (required), frequency (required), report_key (required), recipient_contact_id (required), +12 more.
create_tenancyAdd a tenancyAIdempotentInspect
Adds a tenancy: one or more tenants renting a rental property, or a room in it, from a start date at a weekly rent, with its bond. The property comes from list_properties (add a new one with create_property) and each tenant is a contact of type tenant from list_contacts (add a new tenant with create_contact first). A tenancy of the same property, tenants, room and start date is answered instead of added. Dates are New Zealand dates, yyyy-MM-dd; money is in NZD. Needs the rental module switched on. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the saved tenancy with its organisation's name; rent can then be added with create_income.
Inputs: term_type (required), start_date (required), property_id (required), weekly_rent (required), +11 more.
get_bank_inboxBank inboxARead-onlyIdempotentInspect
The bank inbox for the current New Zealand tax year: the bank transactions from the organisation's bank feed still waiting to be recorded, newest first, each with the record type and contact the app suggests, and how many transactions are to process, reconciled (matched to records), skipped or ignored (not a business transaction). Read only: the person records or reconciles them in the taxapp app; to add a record for one, use create_expense or create_income. Money is in NZD.
Inputs: limit, offset, organisation_id.
get_expense_recordGet an expense recordARead-onlyIdempotentInspect
One expense record in full, by its id from list_expenses: its date and due date, supplier, expense type and account, the amount in NZD, the property for a rental cost, the people liable for it, notes, and whether it is reconciled with the bank.
Inputs: expense_id (required), organisation_id.
get_income_historyIncome historyARead-onlyIdempotentInspect
Income totals across past New Zealand tax years, to compare years or see a trend: commission, rent and tenant reimbursements. Optionally for one of those or one contractor. Money is in NZD. Short stays have no totals here: list them with list_income, each with what the guest paid.
Inputs: income_type, organisation_id, contractor_contact_id.
get_income_recordGet an income recordARead-onlyIdempotentInspect
One income record in full, by its id from list_income: its date, payer, income type, contractor or property and tenancy, the amount received in NZD with any GST in it, taxapp's indicative deductions, notes, and whether it is reconciled with the bank. A short stay or refund also has its shortStay figures: guestPaid (the income), fees, flat-rate credit, booking, dates, nights and how a refund went back.
Inputs: income_id (required), organisation_id.
get_profit_and_lossProfit and lossARead-onlyIdempotentInspect
The profit and loss for one New Zealand tax year, for either commission (a contractor's commission income less the costs of their work) or household (the household's income and costs). For rental properties use get_rental_report instead. Money is in NZD.
Inputs: scope (required), tax_year, organisation_id, contractor_contact_id.
get_reconciliation_statusReconciliation statusARead-onlyIdempotentInspect
How far bank reconciliation (confirming which bank transactions belong to which records) has got for one New Zealand tax year, as counts of what is reconciled and what is still to do. Counts only; reconciling is done in the taxapp app.
Inputs: tax_year, organisation_id.
get_rental_reportRental reportARead-onlyIdempotentInspect
The rental profit and loss for one New Zealand tax year, ready for the IRD rental return (IR3R): rent and other rental income less the deductible rental expenses, per property and apportioned to each owner by their ownership share. Money is in NZD.
Inputs: tax_year, property_id, organisation_id.
get_savings_planSavings planARead-onlyIdempotentInspect
The savings plan for one New Zealand tax year: the opening balance, the amount planned and saved each month, the payments made to IRD and ACC, and taxapp's workings of what the year's tax and ACC levy will be, what is still due and whether the savings are ahead of it. Each payment names the tax year it pays for, and only payments for this year count against it, wherever they were recorded. accLevyInvoices sets the ACC levy out as ACC's invoice does: earnings levied (capped at ACC's maximum), work levy, earners' levy, Working Safer levy and GST. Money is in NZD. Needs the savings module switched on.
Inputs: tax_year, organisation_id.
get_tax_summaryTax summaryARead-onlyIdempotentInspect
A person's tax summary for one New Zealand tax year: their commission (with the GST in it) and their share of the rent received, and taxapp's indicative income tax and independent earner tax credit (IETC), worked out from that year's IRD rates by stepping through the tax brackets (their PAYE salary first, then commission, then rent), with each source's income and tax and the combined total; the employer deducts the tax on the salary, so it is not in the tax payable. The commission's ACC levy is set out as ACC's invoice (commission.accLevyInvoices); it is not income tax. No expenses are deducted. Without a contractor it is the whole organisation's: each person's tax on their own income, added up. These are planning figures to help the person file, not an IRD assessment. Money is in NZD.
Inputs: tax_year, organisation_id, contractor_contact_id.
get_tax_year_overviewTax year overviewARead-onlyIdempotentInspect
The organisation's totals for one New Zealand tax year (1 April to 31 March): income and expenses by type (commission, rental, household) and where the year stands so far, with the commission's ACC levy set out line by line in accLevyInvoices (work levy, earners' levy, Working Safer levy, GST). Start here for questions such as "how is this year going", then use list_income or list_expenses for the records behind a figure. Money is in New Zealand dollars (NZD).
Inputs: tax_year, organisation_id.
list_choicesChoices for new recordsARead-onlyIdempotentInspect
The values the type fields of a new record take in this organisation, each as a value (what the adding tools take) and a label (the words the app shows): the income types and expense types switched on, with commission under the organisation's own word for it (such as "Dental income"), and the contact types, the organisation's own included. Use it to match what the person says ("my dental income", "she is a tenant") to a value; when nothing matches clearly, show the person the labels and ask which they mean.
Inputs: organisation_id.
list_contactsFind contactsARead-onlyIdempotentInspect
Finds the organisation's contacts - the people and businesses it deals with, such as suppliers, tenants, contractors, property owners, landlords and accountants - with their ids, names, contact types and contact details. IRD numbers and bank account numbers are never included. Use the ids with the other tools; to find the contact a person names, search by part of the name. When the person's words match more than one, or none, show them the closest and ask which they mean; never guess an id. Pages of up to 500: the answer gives items, total, offset and limit.
Inputs: limit, offset, search, contact_type, +1 more.
list_contact_typesList contact typesARead-onlyIdempotentInspect
Lists the organisation's contact types with their ids, values and labels, active or not: the ones every organisation has (supplier, tenant, contractor and so on) and the ones it added itself, and whether contacts of each are someone it buys from (supplier) or sells to (customer). Use the ids to change a type with update_contact_type.
Inputs: organisation_id.
list_expense_accountsList expense accountsARead-onlyIdempotentInspect
Lists the expense accounts - the categories expenses are filed under - with their ids, names, any accounting code and the IRD return line (IR10 or IR3R) each one feeds. Every new expense needs one: match what the person says it was for ("fixing the roof" is repairs and maintenance) to an active account's name or IRD line, and when more than one could fit, ask which they mean. New accounts are added in the taxapp app.
Inputs: organisation_id.
list_expensesList expense recordsARead-onlyIdempotentInspect
Lists expense records. Each is one bill or cost with its date and due date, the supplier contact, its expense type, the expense account it is filed under (its category, with the IRD return line it feeds), the amount in NZD, the property for a rental cost, and the people liable for it (the contractors or property owners whose figures it reduces). Filter by tax year, type, account, contact, property or dates. Pages of up to 500: the answer gives items, total, offset and limit.
Inputs: to, from, limit, offset, +6 more.
list_incomeList income recordsARead-onlyIdempotentInspect
Lists income records. Each is one amount received, with its date, the contact who paid it and its income type: commission income names the contractor who earned it; rent and tenant reimbursements name the property and tenancy. Amounts are what was received, in NZD; commission records also show the GST within the amount and taxapp's indicative KiwiSaver, ACC levy, income tax and take-home. A short stay's paid is the payout that reached the bank: its income is shortStay.guestPaid, and its nights count once per booking (a deposit and its balance share one booking reference). A short-stay refund takes its guestPaid off the income; it is never income itself. Filter by tax year, type, contact, contractor, property, tenancy or dates. Pages of up to 500: the answer gives items, total, offset and limit.
Inputs: to, from, limit, offset, +7 more.
list_organisationsList connected organisationsARead-onlyIdempotentInspect
Lists the taxapp organisations this connection covers. An organisation is the account a household or business keeps its records in. For each: its id and name, the person's role there, whether this connection may add and change records there, the features it has switched on (such as commission, rental and reconciliation) and its current New Zealand tax year. Call this first: every other tool needs organisation_id when the connection covers more than one organisation.
Inputs: no named parameters.
list_propertiesList rental propertiesARead-onlyIdempotentInspect
Lists the organisation's rental properties with their owners and each owner's share (rental figures are split between owners by these percentages) and their tenancies: the tenants, the rent and the dates. Use the property and tenancy ids with list_income, list_expenses, get_rental_report and when adding rental income, costs or tenancies; match the property a person names by its label or address. When the person's words match more than one, or none, show them the closest and ask which they mean; never guess an id.
Inputs: organisation_id.
list_scheduled_reportsList scheduled reportsARead-onlyIdempotentInspect
Lists the organisation's scheduled reports: which report, who it is emailed to and copied to, how often and when (New Zealand time), when it next goes, when it last went and any problem sending it, and whether it is switched on. Only an owner of the organisation can see and set up scheduled reports.
Inputs: organisation_id.
list_scheduled_report_typesReports that can be scheduledARead-onlyIdempotentInspect
The reports this organisation can email on a schedule, each with its key (what create_scheduled_report takes), its name and what it contains, what it is about (Contractor, Property, Tenancy or None: give that contractor_contact_id, property_id or tenancy_id) and the period it covers. Only an owner of the organisation can see and set up scheduled reports.
Inputs: organisation_id.
send_scheduled_report_nowSend a scheduled report nowAInspect
Emails a scheduled report now, by its id from list_scheduled_reports, to its recipient and everyone copied, covering the period its next run will cover. Its schedule stays as it is. It sends an email every time, so confirm with the person first. Only for an organisation where this connection may add and change records (list_organisations says which). The answer says who it was sent to.
Inputs: scheduled_report_id (required), organisation_id.
set_contact_acc_classificationsSet a contractor's ACC classificationsADestructiveIdempotentInspect
Sets the ACC classification periods of a contractor, by their contact id from list_contacts, from the details on their ACC invoice: what work they do and its levy rate, for the dates it applies. The list replaces every period they have now, so start from the periods list_contacts shows and include the ones that stay, by id. taxapp works out the ACC levy from these. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the changed contact.
Inputs: contact_id (required), acc_classifications (required), organisation_id.
set_contact_paye_salarySet a PAYE earner's salaryADestructiveIdempotentInspect
Sets the yearly salary or wages a person earns from an employer, taxed through PAYE, by their contact id from list_contacts. The contact must have the paye-earner contact type; add it with update_contact first if they do not. taxapp stacks their commission and rental income on top of it to work out the tax rate that applies; 0 when they have none. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the changed contact.
Inputs: contact_id (required), annual_paye_salary (required), organisation_id.
update_contactChange a contactADestructiveIdempotentInspect
Changes a contact that is already there, by its id from list_contacts: its name, contact types, email, phone numbers, website, addresses, IRD number or notes. contact_types replaces the types it has now, so include the ones it keeps. A PAYE earner's salary and a contractor's ACC classifications have their own tools. Give only what changes: every parameter left out keeps the value the record has now. Read the record first, and confirm the change with the person before making it. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the changed contact.
Inputs: contact_id (required), name, clear, email, +11 more.
update_contact_typeChange a contact typeADestructiveIdempotentInspect
Changes a contact type the organisation added itself, by its id from list_contact_types: its label, whether it is a supplier or customer type, or whether it is active (an inactive type is not offered for contacts; contacts keep it). The types every organisation has stay as they are. Give only what changes: every parameter left out keeps the value the record has now. Read the record first, and confirm the change with the person before making it. Only for an organisation where this connection may add and change records (list_organisations says which).
Inputs: contact_type_id (required), label, active, is_customer, +2 more.
update_expenseChange an expense recordADestructiveIdempotentInspect
Changes an expense record that is already there, by its id from list_expenses: its date or due date, expense account, supplier, amount, property, the people liable for it, or its notes; its expense type never changes. Send only what the person tells you; taxapp works out every total from it. Give only what changes: every parameter left out keeps the value the record has now. Read the record first, and confirm the change with the person before making it. A record sent to Xero keeps its amount and date. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the changed record as list_expenses shows it.
Inputs: expense_id (required), clear, notes, amount, +7 more.
update_expense_accountChange an expense accountADestructiveIdempotentInspect
Changes an expense account, by its id from list_expense_accounts: its name, code, IRD return line, or whether it is active (an inactive account is not offered for new expenses; its expenses stay). The accounts every organisation starts with keep their name and code; their IRD line and active switch can change. Give only what changes: every parameter left out keeps the value the record has now. Read the record first, and confirm the change with the person before making it. Only for an organisation where this connection may add and change records (list_organisations says which).
Inputs: expense_account_id (required), code, name, clear, +3 more.
update_incomeChange an income recordADestructiveIdempotentInspect
Changes an income record that is already there, by its id from list_income: when the money arrived, how much, who paid it, the contractor, property, tenancy, the bill a reimbursement pays back, a short stay's platform figures, booking and dates (or cancelling or reinstating it), or its notes. Its income type never changes. Send only what the person tells you: taxapp works out GST, KiwiSaver, the ACC levy, income tax and take-home from the amount again, exactly as the app does. Give only what changes: every parameter left out keeps the value the record has now. Read the record first, and confirm the change with the person before making it. A record sent to Xero keeps its amount and date. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the changed record as list_income shows it.
Inputs: income_id (required), paid, clear, notes, +16 more.
update_propertyChange a rental propertyADestructiveIdempotentInspect
Changes a rental property, by its id from list_properties: what it is called, its address, who owns what share of it, or whether it is still active (a property that was sold or is no longer let; its records stay). owners replaces every owner it has now, so include the ones that stay; the shares add up to exactly 100. Give only what changes: every parameter left out keeps the value the record has now. Read the record first, and confirm the change with the person before making it. Needs the rental module switched on. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the changed property.
Inputs: property_id (required), clear, label, active, +3 more.
update_savings_planChange the savings planADestructiveIdempotentInspect
Changes the savings plan of one New Zealand tax year: its opening balance, the months' planned and saved amounts, or the payments made to IRD or ACC. A payment counts against the tax year it pays for, which may be the year before the plan's: get_savings_plan shows it as taxYearEnding. Each list given replaces that list as a whole, so start from get_savings_plan and include the entries that stay; a list left out keeps what it has. Send only what the person tells you: taxapp works out the tax, levy and what is still due. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the plan as get_savings_plan shows it.
Inputs: tax_year (required), acc_payments, ird_payments, monthly_entries, +2 more.
update_scheduled_reportChange a scheduled reportADestructiveIdempotentInspect
Changes a scheduled report, by its id from list_scheduled_reports: its name, report, recipient, who is copied, how often and when it goes, or switches it off or on. Give only what changes: every parameter left out keeps the value the record has now. Read the record first, and confirm the change with the person before making it. Only an owner of the organisation can see and set up scheduled reports. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the changed schedule.
Inputs: scheduled_report_id (required), name, clear, enabled, +14 more.
update_tenancyChange a tenancyADestructiveIdempotentInspect
Changes a tenancy, by its id from list_properties: its tenants, landlords, term, dates, weekly rent, bond, room or notes, such as a rent rise, a tenancy ending, or the bond being lodged or refunded. Its property never changes. tenant_contact_ids and landlord_contact_ids replace the lists it has now. Dates are New Zealand dates, yyyy-MM-dd; money is in NZD. Give only what changes: every parameter left out keeps the value the record has now. Read the record first, and confirm the change with the person before making it. Needs the rental module switched on. Only for an organisation where this connection may add and change records (list_organisations says which). The answer is the changed tenancy.
Inputs: tenancy_id (required), clear, notes, end_date, +11 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Track Australian work-related tax deductions: expenses, assets, car trips and work-from-home days.
Calculate sales tax & VAT, record transactions and refunds, manage products and customers.
NZ working-day deadlines with the law section cited, plus IRD, NZ bank and ABN checksum checks.
Log business expenses with the VAT split and mileage, total them, export CSV or XLSX.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables users to estimate UK taxes, check Making Tax Digital status and deadlines, and run payroll, VAT, IR35 and other calculators without an account. With OAuth access, it also lets users review transactions, log mileage, create and manage invoices, and prepare quarterly updates from their own records.MIT
- AlicenseAqualityBmaintenanceLogs deductible driving trips, manages effective-dated mileage rates, computes per-category summaries, and exports CSV for accountants, all locally with no network calls.939 npmMIT
- AlicenseAqualityCmaintenanceEnables an AI assistant to read Portuguese invoices and receipts, file them by tax year, and book them into an Excel or Google Sheets workbook. It works out the boxes of the quarterly IVA return, tracks IRS and Segurança Social totals, and reports what documents are still missing.16MIT
- AlicenseBqualityBmaintenanceWork with Crunch accounting from your AI assistant: clients, invoices, expenses, bank and reports. Read-only by default.63MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.