Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Open Accountants for Gemini CLI

Global tax and accounting knowledge built with accountants around the world, with official sources and transparent authorship and review status.

This extension connects Gemini CLI to the Open Accountants knowledge network, so Gemini can answer tax and accounting questions from Guides that cite an official source and carry an explicit review status, instead of from recall.

Install

gemini extensions install https://github.com/openaccountants/gemini-cli-extension

Then confirm the server is connected:

gemini mcp list

No API key or configuration is needed to connect. Anonymous use is capped at a small number of free questions, after which the server returns a sign-in prompt with a link to create a free account. The Guides themselves are free to read.

Direct install without the extension

If you would rather add the server on its own:

gemini mcp add --transport http open-accountants https://www.openaccountants.com/api/mcp

You get the tools this way, but not the GEMINI.md context that tells Gemini when to use them and how to handle jurisdiction, sources and review status.

What you get

As of 5 August 2026 the live network holds 1,790 Guides across 244 jurisdictions: 188 country-level jurisdictions, 52 US state-level jurisdictions, and 4 regional or cross-border groupings. Of those Guides, 188 carry an attestation from a credentialed accountant; the rest are accountant-authored or source-cited drafts. Coverage per jurisdiction is uneven, and list_jurisdictions reports the per-jurisdiction counts so you can see what is thin before you rely on it.

Topics covered: income tax, corporate tax, VAT/GST and sales tax, payroll, audit and audit exemption, company formation and entity choice, capital gains, crypto, tax residency, filing deadlines, and cross-border and relocation taxation.

Example prompts

What VAT registration rules apply to a Maltese company selling services to
business customers in Germany?

Compare the tax treatment of a self-employed freelancer in Malta and Portugal.

What payroll records does a UK company need to retain, and for how long?

I am moving from the UK to the UAE in November. What are the tax consequences
on both sides?

Does my Irish company qualify for audit exemption this year?

Show me the accountant-written sources behind that answer.

Tools

Tool What it does
start Routes a tax question to the right Guides for the jurisdiction. Start here.
start_help Explains how to frame a question for the best routing.
search_rules Searches individual cited rules across jurisdictions.
search_skills Full-text search across Guides.
list_skills Lists Guides, filterable by jurisdiction and topic.
get_skill Returns a complete Guide with its sources and review status.
get_skill_sections Returns specific sections of a Guide.
list_jurisdictions Shows coverage and Guide counts per jurisdiction.
list_rule_facets Lists available topics, domains and roles for filtering.
get_deadlines Filing and payment deadlines for a jurisdiction.
check_audit_exemption Checks audit exemption thresholds for a company.
validate_vat_number Validates an EU VAT number against VIES.
list_verifiers Names the accountants behind the Guides, with credentials.
share_with_openaccountants Sends a correction or a question to the network. User-initiated only.

How the Guides are written and reviewed

Guides are authored by accountants and carry one of three review states, which the tools return with every result:

State What it means
Source-cited draft Published with citations to official sources. No credentialed human has reviewed it.
Accountant-authored Written by an accountant with a public licence number on file.
Attested by another accountant A second credentialed professional has publicly stood behind that version.

Verification is fact by fact, and the accountant who attests is named and personally accountable. A cited official source proves where a rule came from, not that it is still current. Confirm figures against the source before acting.

Privacy and security

  • No credentials to configure. The Guides are public and the server connects without a key. Anonymous use is capped at a small number of free questions, after which the server asks you to create a free account.
  • What is sent. Only the query text your prompt produces (the topic and the jurisdiction). No files, no code, no credentials.
  • Read-only by default. Thirteen of the fourteen tools only read. The one exception, share_with_openaccountants, sends a correction or a question to the network, and only when you explicitly ask for it.
  • Transport. HTTPS to https://www.openaccountants.com/api/mcp.
  • Full policy: https://www.openaccountants.com/privacy

Not tax advice

Open Accountants is a research layer. It gives you the reviewed method, the official source, and a named professional, which is more than a guess and less than advice. Anything that ends in a filing position, a valuation, or a number a tax authority will see should go past a qualified local accountant first.

Links and support

Licence

Extension files in this repository: MIT. The Guides themselves are published under the Open Accountants Guide License v1.0 in the main repository.

About

Global tax and accounting knowledge written and maintained by accountants around the world. Gemini CLI extension for the Open Accountants MCP server.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors