Openaccountants

OpenAccountants

The open-source tax layer for AI agents.

1,000+ skills across 190+ jurisdictions — research-verified, with an accountant-verified tier signed off by named CPAs/CAs/EAs. Works with Claude, ChatGPT, Cursor, Windsurf, and any MCP-compatible agent.

⚠️ General reference only — not advice. OpenAccountants provides general tax and accounting reference material for AI-assisted workflows. It is not a law firm, accounting firm, tax preparer, or return-filing service, and its outputs are not tax, legal, accounting, or financial advice. Skills may be incomplete, outdated, or wrong, and are not reviewed for any specific person's facts, elections, deadlines, residency, or local procedures. Always have a qualified professional review outputs before filing, payment, or action. Research-verified skills have not been reviewed by a credentialed accountant.

What it does

You:    "I want to file my VAT return in Brazil."
          ↓  OA loads br-indirect-tax, brazil-vat, brazil-einvoice
AI:     Brazil indirect tax rules (PIS/COFINS/ICMS)
        Filing workflow, step-by-step
        Required documents checklist
        E-invoice compliance check
        ─────────────────────────────────────────
        Verified by Ariane Marrocos CRC/SP
        [Request accountant review →]

You:    "I'm a freelancer in South Africa. What do I owe?"
          ↓  OA loads za-income-tax, za-provisional-tax
AI:     ITR12 working paper
        Provisional tax schedule (IRP6 — Aug + Feb)
        Medical tax credits
        Retirement annuity deduction
        ─────────────────────────────────────────
        Verified by Werner Britz CA(SA)
        [Request accountant review →]

You:    "Help me set up a company in Malta."
          ↓  OA loads malta-formation, malta-income-tax, malta-vat-return
AI:     Entity type comparison (Ltd vs partnership vs sole trader)
        Registration steps + costs
        Post-formation compliance checklist
        ─────────────────────────────────────────
        Verified by Michael Cutajar CPA (Malta)
        [Request accountant review →]

Install via MCP → | Browse skills → | For accountants →

Verified accountants: Werner Britz CA(SA) · Michael Cutajar CPA (Malta) · Ariane Marrocos CRC/SP · James Power (UK) · Mayur Deokar CA (India) · Rilia Putri CA (Indonesia) · Ashish Bista CA (Nepal) · Mário Vale CA (Portugal) · Mehran Habib (Saudi Arabia) · Amir Pelinkovic CPA (US)

Two ways to use

The MCP path is the canonical product. This repo is the open research base that backs it.

Quick start (60 seconds)

1. Find your jurisdiction

packages/
├── malta/           ← income tax + VAT + SSC + payroll + formation + bookkeeping
├── uk/              ← SA103/SA100 + VAT100 + NIC + CGT
├── germany/         ← Einkommensteuer + UStVA + payroll (fullest package)
├── brazil/          ← IRPF + PIS/COFINS + e-invoice + payroll
├── south-africa/    ← ITR12 + VAT + provisional tax
├── ... 130+ more countries
├── us-ca/           ← Federal Schedule C/SE + California state
├── us-ny/           ← Federal + New York state
├── ... 51 US state packages
├── ca-on/           ← Federal T1/T2125 + Ontario
├── ca-qc/           ← Federal + Quebec (incl. QST)
├── ... 13 Canadian province/territory packages

New here? Read START-HERE.md — scenarios, file lists, what to say to the AI.

Canadian packages: if ca-on/, ca-qc/ etc. are missing, run python3 scripts/build-packages.py once.

2. Upload to your AI

• Claude.ai → Create a Project, add files as Project Knowledge
• ChatGPT → Attach files or create a Custom GPT
• Any other LLM → Attach or paste the files

3. Go

Help me with my 2025 taxes. Here's my bank statement.
Help me set up a company in Malta.
Run my payroll for this month.
Prepare my annual accounts.
Optimize my tax — what deductions am I missing?
Check my invoice compliance for EU e-invoicing.

The AI asks a few questions, loads the right skills, and produces a working paper for your accountant.

Verified accountants

These licensed practitioners have reviewed and signed off skills for their jurisdictions. Their name appears on every answer the AI gives.

Verified skills (Tier 1) are served via the MCP server with the verifier's name on every output. The research drafts in this repo are Tier 2.

What's in each package

Special packages: _cross-border/ (37 skills) · _verticals/ (14 industry skills) · _integrations/ (10 platform skills: Xero, QuickBooks, Stripe, Wise, Shopify, and more)

Coverage

Full accounting suite (13 countries)

Tax + bookkeeping + payroll + formation + financial statements + transfer pricing + tax optimization:

Malta · UK · Germany · Australia · Canada · India · Spain · France · Japan · Netherlands · Portugal · Belgium · United States (CA)

Multi-skill countries (~56 countries)

VAT + income tax + social contributions (and often more):

Argentina, Austria, Belgium, Brazil, Bulgaria, Chile, China, Colombia, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, Greece, Hong Kong, Hungary, Indonesia, Ireland, Israel, Kenya, Latvia, Lithuania, Luxembourg, Malaysia, Mexico, New Zealand, Nigeria, Norway, Pakistan, Panama, Peru, Philippines, Poland, Qatar, Romania, Saudi Arabia, Singapore, Slovakia, Slovenia, South Africa, South Korea, Sweden, Switzerland, Taiwan, UAE, and more.

Crypto tax (22 countries + all 51 US states)

Malta, UK, Germany, France, Australia, Canada, Israel, India, Japan, Spain, Netherlands, Portugal, Italy, Singapore, Brazil, Mexico, Sweden, Belgium, Switzerland, South Korea, New Zealand, and every us-<state> package.

VAT/GST only (65 countries)

Consumption tax classification with local supplier pattern libraries. From Albania to Zimbabwe.

Full coverage breakdown: docs/QUALITY-TIERS.md

How the skills work

The supplier pattern library

Every skill contains a lookup table of local vendors. When the AI sees "BANK OF VALLETTA" or "DEUTSCHE TELEKOM" or "STRIPE PAYMENTS UK LTD" on your bank statement, it already knows the classification — no guessing.

Three outcomes per transaction

Conservative defaults

When uncertain, the system always assumes MORE tax, never less. Your accountant can override a conservative position. They can't easily undo an aggressive one.

MCP server

Install once, configure once — every future conversation pulls the right skills automatically.

You:    "Help me set up a company in Germany and understand payroll"
          ↓
Claude: list_jurisdictions → sees "germany"
        get_skill("germany-formation") → entity types, registration, costs
        get_skill("germany-payroll") → PAYE, social security, employer obligations
          ↓
Claude: walks you through entity choice, registration steps, payroll setup

Install

git clone https://github.com/openaccountants/openaccountants.git
cd openaccountants
pip install ./mcp          # requires Python 3.10+

Connect

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "openaccountants": {
      "command": "openaccountants-mcp"
    }
  }
}

Cursor — add to .cursor/mcp.json or via Settings > MCP:

{
  "mcpServers": {
    "openaccountants": {
      "command": "openaccountants-mcp"
    }
  }
}

Full setup, uv instructions, environment variables: mcp/README.md

Are you an accountant?

Most skills are research-verified — drafted from primary legislation but awaiting a credentialed sign-off. Your review moves them to accountant-verified, and your name goes on every answer the AI gives.

You don't need GitHub. Just:

1. Find your country's folder under packages/
2. Check rates against your tax authority's website
3. Ema

…