Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres
Open-source accounting MCP server: ledgers, invoices and VAT on your own Postgres
- Pricing
- Freemium
- Platforms
- API, CLI, Self-hosted
- Runs
- Locally or Remotely
- Version
- 0.24.0
- Listing updated
- 5 days ago
Similar MCP servers
About Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres
Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres is a freemium MCP server for databases. It can run locally on your machine or as a hosted remote server.
The server has no powers of its own. It signs in as the person using it, so a viewer can read but not write, a member of one company cannot see another, and a locked period refuses postings. Those rules live in the schema's row level security and triggers, not in this package. It refuses to start with a Supabase service_role key, because that would bypass every policy.
Three things it will never do, according to the README: write a ledger line directly (entries come from the schema's own functions), delete or edit a posted entry, or use a service role key. A posted invoice is undone only the way its country allows, by returning it to draft or issuing a credit note. Environment settings can put sessions in autopilot or review mode for how documents are posted.
There are two routes. The hosted endpoint at mcp.ekwo.ai/mcp uses OAuth, holds no books itself and asks you to decide on the approval screen whether the agent may write. The local npm package @ekwo-ai/mcp runs over stdio against any installation without an account, through PostgREST or a direct Postgres URL. Rules for about 175 countries are kept as data packs, covering charts of accounts, tax codes and VAT return boxes.
Install
Run in a terminal
claude mcp add --transport http mcp https://mcp.ekwo.ai/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.ekwo.ai/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.ekwo.ai/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.ekwo.ai/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"serverUrl": "https://mcp.ekwo.ai/mcp"
}
}
}Add to Grok Bot desktop app → Connect apps → Add a custom connector
https://mcp.ekwo.ai/mcpEnter a Name (for example "Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.
Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"type": "http",
"url": "https://mcp.ekwo.ai/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
SUPABASE_URLhttps://<ref>.supabase.co of your own projectSUPABASE_ANON_KEYThe anon (publishable) key. Never the service_role key: the server refuses it.EKWO_EMAILThe user the agent acts asEKWO_PASSWORDThat user's passwordEKWO_ACCESS_TOKENAn access token, instead of email and passwordEKWO_DB_URLDirect Postgres connection, for a self-hosted database without PostgRESTEKWO_ACT_AS_USER_IDRequired with EKWO_DB_URL: the auth.users id the server acts forEKWO_EINVOICE_DIRECTORYOptional: the folder electronic invoices are sent to. Unset, they are issued and kept, and not sentEKWO_AGENT_POSTINGOptional: autopilot or review, how this session posts documents. Unset, each company's agent_posting decides
What it does
- Acts as the signed-in user
- Everything follows the user's row level security.
- No direct ledger writes
- Entries come only from the schema's accounting functions.
- Posted entries stay posted
- No tool deletes one; reversal uses the country's allowed route.
- Service-role refusal
- The server will not start with a service_role key.
- Country packs
- About 175 countries' charts, taxes and return boxes as data.
- Hosted or local
- OAuth remote endpoint or stdio via npx.
- Autopilot or review
- Choose how a session posts documents.
Good for
- Raise and post a sales invoice by asking
- Prepare a VAT return from confirmed documents
- Import and match bank statement files
- Read a trial balance across a company's journals
- Let an accountant's agent work across client companies
Pricing
Freemium
Open source (AGPL-3.0) core; Free plan; Hosted €20/user/mo billed yearly; Pro €30/user/mo
Prices change. Check ekwo.ai before you buy.
More servers for the same service
Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres FAQ
Can the agent change posted entries?
No. The README says no tool deletes or edits a posted entry.
Which database does it use?
Your own Supabase or Postgres. The hosted server holds none of the books.
How do I run it locally?
Run npx -y @ekwo-ai/mcp@latest with the Supabase URL, anon key and the user's credentials set.
Is it open source?
The site says Ekwo OS is free under AGPL-3.0.
What does Ekwo cost?
A free plan exists; Hosted lists €20 per user per month billed yearly and Pro €30.
Is Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres free?
Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres has a free plan, with paid plans for more usage or features.
How do I add Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres to Claude Code?
Run this command in your terminal: claude mcp add --transport http mcp https://mcp.ekwo.ai/mcp
What are the best alternatives to Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres?
The closest alternatives to Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres are Aikount MCP, DIY Accounting Submit, bokio-mcp, AUTOPILOT and Sevdesk MCP.
Where this comes from
- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.