Ekwo OS MCP
Ekwo OS accounting on your own Supabase: Claude posts invoices, matches payments and prepares VAT under your rights
- 42 ★ on the repository
- Last commit
- AGPL-3.0
Broad access
Why this level
- The agent reads the company ledger and bank data and can create invoices, payments and entries
- The user's password or session token sits in the client config
- Prepared VAT and tax returns affect reporting to the tax authority
Install
- Works in
Manual install
npx -y ekwo-os@latest initInstalls the core and country packs into your Supabase project; Node 20+ required.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent reads the company ledger and bank data and can create invoices, payments and entries
- The user's password or session token sits in the client config
- Prepared VAT and tax returns affect reporting to the tax authority
This is third-party code. Review the repository files before installing.
What it does
Ekwo OS is open-source double-entry accounting for your own Postgres database on Supabase. The schema, country tax rules and the ekwo command line ship in one package, and an MCP server lets an AI agent work in the same books: read the ledger, raise an invoice, post it, match a payment and prepare a VAT return. The server acts as the person, under the row level security of your installation, and never uses a service_role key: it refuses to start with one. Entries come only from the schema's own functions, with no direct ledger-line writes. No tool deletes or edits a posted entry; an invoice goes back to draft or is closed by a credit note. There are two ways to reach it. The hosted https://mcp.ekwo.ai/mcp connects as a remote server with a browser sign-in, and on the consent screen the person decides whether the agent may write. The local one runs by `npx -y @ekwo-ai/mcp@latest` over stdio and signs in to Supabase as a user. Every supported country has a data pack: chart of accounts, taxes, declaration boxes and financial statements. They feed files such as the French FEC, XBRL, Peppol UBL and Factur-X. Modules cover fixed assets, budgets, corporate income tax and e-invoicing.
Who it is for. Small companies and accounting firms keeping books in their own Supabase who want Claude to prepare entries and VAT.
Good fit when
- A supplier invoice arrived in a foreign language and must be posted with confirmation
- A bank statement is loaded and payments need matching to invoices
- Before filing a VAT return you need the data pulled from the books
- You want answers on cash runway and how fast customers pay, from the books
- An accounting firm keeps several companies in one installation with separate rights
Not a fit when
- You want a ready cloud service with no database of your own: you must set up Supabase or take Ekwo Cloud
- The country is not among the supported packs
- You need a legal guarantee of the return: the README points to DISCLAIMER.md, and this is a tool, not an accountant
- You want the agent to write without a human decision: on the hosted server the person grants write access on the consent screen
Example request
Show unpaid customer invoices and prepare a draft VAT return for last quarter. Post nothing without my confirmation.MCP
- Transport
- stdio, http
- Authentication
- OAuth
Environment variables
SUPABASE_URLrequired- Address of your Supabase project.
SUPABASE_ANON_KEYrequired- The public (anon) Supabase key.
EKWO_EMAILrequired- Email of the user the server acts as.
EKWO_PASSWORDrequired, secret- The user's password. EKWO_ACCESS_TOKEN can replace the email and password pair.
Limitations
A Supabase project and Node 20 or newer are needed, and the free Supabase plan is enough to start. The installer asks for the connection string, country, chart of accounts and the first administrator.
After install the README advises turning off public sign-ups in Supabase, keeping two administrators and keeping the service_role key off unneeded machines.
The license is AGPL-3.0, and contributions require signing a CLA. The server is tested on Postgres compiled to WebAssembly, so check behavior on your Supabase version with `ekwo doctor`.
A prepared return remains an estimate until the owner confirms it: the corporate tax module computes an estimated figure.
How to disable. Remove the ekwo entry from the MCP client config. The hosted server is disconnected in the client's connections settings, and the books stay in your Supabase database, which is deleted separately.
FAQ
How do I install Ekwo OS?
Create a project at supabase.com and run `npx -y ekwo-os@latest init`. The installer applies migrations, loads country packs, creates the administrator in your Supabase Auth and opens the first financial year. Running it twice duplicates nothing.
How do I connect the Ekwo MCP server to Claude Code?
Add to .mcp.json a server with command npx, args -y @ekwo-ai/mcp@latest and env SUPABASE_URL, SUPABASE_ANON_KEY, EKWO_EMAIL and EKWO_PASSWORD. The hosted https://mcp.ekwo.ai/mcp needs an Ekwo Cloud account.
Can an agent damage posted entries?
No. No tool deletes or edits a posted entry, and a locked period blocks writes at the trigger level. Reversal goes through returning an invoice to draft or a credit note.
Which countries are supported?
Every country in the README list has a data pack, and the installer loads them all. The version and review status of each pack are in the repository's docs/packs.md.
What is Ekwo Cloud?
The same team's web application on the same books: invoices, bank statements, VAT returns and electronic invoices. The hosted MCP server runs through Ekwo Cloud and needs a free account.
Discussion
No questions or reviews yet.
Related
MCP serversBeancount.io gives an agent the books: BQL queries, file edits, entries, statement parsing and bank import.
The official Xero MCP server: an agent reads invoices, contacts, journals and reports and creates invoices, payments and timesheets
Invoices, acts and UPD in Elba from an agent chat, public document links for clients and a summary of unpaid bills
MCP connects AI assistants to jurisdiction-specific tax references with sources for rates, thresholds and deadlines.
A Claude Code plugin that runs Swedish bookkeeping over MCP: vouchers, VAT, payroll and period close only after your approval.
RoboSystems graph MCP endpoint: an agent queries company financial data and SEC XBRL filings in a knowledge graph
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Ekwo OS (this card) | yes | OAuth | 42 | |
| Xero MCP Server | yes | OAuth | 392 | a connection to the cloud accounting service Xero |
| QuickBooks Online MCP Server | yes | OAuth | 450 | a connection to QuickBooks Online |
| Odoo MCP | no | API key | 432 | access to the Odoo ERP |
README in short
The README sets out the idea: data belongs to the business and the work on it can be done by software the business also owns. Then come the contents (core, country packs, command line, MCP server, modules, financial analysis), install on your own Supabase, the rights model and security.