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.
• 9 tax and super worksheets: GST, resident basic tax, CGT, FBT, first-year depreciation, quarterly SG, Schedule 1 PAYG withholding, super contribution caps and account-based pension minimums, each within a stated period and scope.
• 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, or AUS_ACCOUNTING_CORPUS_ROOT to a legislation corpus, such as one built by au-tax-legislation-corpus. The package ships neither. A corpus row is a point-in-time copy, not a live lookup.

The reference covers every exclusion, input rule, prompt, resource, the evidence pack format and the evaluation suite. The website guide has further examples.

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.

Licence and releases

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