Skip to content
MCP server

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

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.ekwo.ai/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.ekwo.ai/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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/mcp

Enter 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.

Full Grok Bot setup guide

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 project
  • SUPABASE_ANON_KEYThe anon (publishable) key. Never the service_role key: the server refuses it.
  • EKWO_EMAILThe user the agent acts as
  • EKWO_PASSWORDThat user's password
  • EKWO_ACCESS_TOKENAn access token, instead of email and password
  • EKWO_DB_URLDirect Postgres connection, for a self-hosted database without PostgREST
  • EKWO_ACT_AS_USER_IDRequired with EKWO_DB_URL: the auth.users id the server acts for
  • EKWO_EINVOICE_DIRECTORYOptional: the folder electronic invoices are sent to. Unset, they are issued and kept, and not sent
  • EKWO_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.

How AIPoweredBot checks servers