Aus Accounting MCP

Australian accounting tools for Claude, Cursor, Codex and other MCP clients. The server runs on your machine over stdio, needs no API key or account, and makes no network calls once installed.

• ATO small business benchmarks: compare a business's P&L figures with the benchmark ranges for its industry.
• Payday Super: review contribution timing for one payday or a whole employer, and build a 4-file evidence pack for a practitioner's workpaper.
• Division 7A: get the benchmark interest rate and review s 109N loan terms and s 109E minimum yearly repayments for one loan. Matters outside that scope are refused.
• 10 tax and super worksheets: GST, resident basic tax, CGT, FBT, first-year depreciation, quarterly SG, Schedule 1 PAYG withholding, super contribution caps, account-based pension minimums and study and training loan repayments, each within a stated period and scope. A source checkout serves the tenth now; an installed server gets it only after the next australian-tax-calculators release and the aus-accounting-mcp release that moves its engine pin.
• Cited research: search your own Markdown library, or a local copy of federal tax legislation, with every result cited to its file and line, or its Act, section and compilation.
• Test data: generate synthetic CTR and BAS fixtures for integration testing.

Not tax advice. Payday Super and Division 7A reviews are experimental and need human review before consequential accounting action. Fixtures are not a lodgement. Ryan Duguid is not a registered tax agent or BAS agent. Project support is limited to software issues reproduced with fabricated data. Do not send taxpayer information or request advice, return preparation, tax-treatment confirmation, or lodgement. See DISCLAIMER.md.

Install

Requires Python 3.10+ and uv:

uvx aus-accounting-mcp

The server waits for an MCP client over stdio. Tool calls read bundled data and any folders you configure. They do not contact the ATO or the Federal Register, change records or lodge. Your MCP host still sends tool arguments and results to its model provider, so use fabricated data with a hosted model.

uvx keeps the version it first downloaded. To upgrade, name the release in your client configuration, for example aus-accounting-mcp==<version>.

Client integration

For Claude Desktop, Cursor, Windsurf and other hosts that run local stdio servers:

{
  "mcpServers": {
    "aus-accounting": {
      "command": "uvx",
      "args": ["aus-accounting-mcp"]
    }
  }
}

Add to Cursor, or from a terminal:

claude mcp add --scope user aus-accounting -- uvx aus-accounting-mcp
codex mcp add aus-accounting -- uvx aus-accounting-mcp

The client setup guide covers Gemini CLI, VS Code, Zed and others. ChatGPT connectors and the Claude.ai web app accept only remote servers, so they cannot run this one.

Example requests

Ask in plain English. Each of these fabricated requests resolves to one tool call:

Tools

Missing figures remain unknown. Preserve UNKNOWN, REFUSED, not_supplied and null results; ok: true means the tool ran, not that a review passed. Supply an explicit assessment date and fund-receipt evidence, both the date and the amount received (received with matched_amount), before reading a Payday Super result as ON_TIME.

The research tools need a folder you supply: set AUS_ACCOUNTING_LIBRARY_ROOT to an authorised Markdown folder, AUS_ACCOUNTING_CORPUS_ROOT to a legislation corpus, or AUS_ACCOUNTING_RULINGS_ROOT to ATO rulings runs, such as those built by au-tax-legislation-corpus. The package ships none of them. A corpus or rulings row is a point-in-time copy, not a live lookup, and an edited version of private advice cannot be relied on by anyone. Point the library at reference material, or at one engagement at a time, never at a folder of mixed client files: every match enters the assistant's context, whichever client it came from.

The reference covers every exclusion, input rule, prompt, resource, the evidence pack format and the evaluation suite. The website guide has further examples. For the supplier information a firm needs for its AI register, and answers to the questions buyers put to tax-research tools, see For a firm assessing this server.

30-second demonstration

From apps/aus-accounting-mcp/ in a repository checkout, run the fabricated example. It shows the tools running on synthetic data; it is not evidence that a review passed:

uv run --locked aus-accounting-mcp-demo

The checked text transcript and proof and provenance record the expected output, limitations and asset source.

Conformance cases

conformance/cases.json holds eight Payday Super and Division 7A calls with the results this server returns, including the cases it leaves UNKNOWN or refuses. Another implementation can replay them; see conformance/README.md.

Licence and releases

MIT License. Created by Ryan Duguid. Release notes, v0.2.12 release record, CITATION.cff.