Aus Accounting MCP

Local Australian accounting tools for AI assistants. Compare business figures with ATO benchmarks, review Payday Super timing and check limited Division 7A loan terms and repayments. Calculate six bounded tax worksheets and search a configured local Markdown library with file and line citations. Includes synthetic CTR/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. See DISCLAIMER.md.

Install

Requires Python 3.10+ and uv:

uvx aus-accounting-mcp

The server waits for an MCP client over stdio. No API key is required. Installation downloads packages; tool calls use bundled data locally without contacting services or changing records. It does not retrieve ATO documents or lodge returns.

Client integration

For Claude Desktop, Cursor and other clients that support local stdio servers:

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

Add to Cursor or use the client setup guide.

For Codex:

codex mcp add aus-accounting -- uvx aus-accounting-mcp

For Claude Code:

claude mcp add aus-accounting -- uvx aus-accounting-mcp

Tools

Missing figures remain unknown. Preserve UNKNOWN, REFUSED, not_supplied and null results; ok: true means the tool ran, not that a review passed.

The six worksheets cover bounded GST, resident basic tax, CGT, FBT, first-year depreciation and quarterly SG cases. Read aus-accounting://scope before supplying scope confirmation. Most support 2025-26; see the reference for periods and exclusions. To enable library retrieval, set AUS_ACCOUNTING_LIBRARY_ROOT in the server's environment to an authorised Markdown folder. Returned excerpts enter the calling assistant's context. The package contains no reference library.

Payday Super needs an explicit assessment date and fund-receipt evidence before it can return ON_TIME. Check the aus-accounting://payday-coverage resource for bundled rate and calendar coverage, and retain the result's caveats.

Division 7A covers the reviewed s 109N/s 109E scope only. It refuses matters such as forming amalgamated loans, s 109R repayment classification, unpaid present entitlements and distributable surplus. The reference covers all exclusions, input rules, prompts, resources and evaluation instructions.

30-second proof

From apps/aus-accounting-mcp/ in a repository checkout, run the fabricated example:

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.0 release record, CITATION.cff.