AI & MemoryMCP RegistrynpmA · 87

Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres MCP server

Name: Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres
Author: ekwo.ai

ai.ekwo · Updated today

Double-entry books an agent keeps as the user: invoices, VAT returns, 174 country packs.

At a glance

Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres is an MCP server in the AI & Memory category. It runs locally over stdio via `npx -y @ekwo-ai/mcp`, and needs SUPABASE_ANON_KEY, EKWO_PASSWORD, EKWO_ACCESS_TOKEN and EKWO_DB_URL. It scores A (87/100) on the MCP Skills Hub health score as of Oct 27, 2026.

Source 40

One-click install

VS Code VS Code Insiders Cursor

Opens your editor and pre-fills the config. Your editor will ask before adding it.

How to install Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres in your AI client

Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.

How to install Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres in Claude CodeAnthropic's agentic CLI

Add the server

bash

claude mcp add ekwo -e 'SUPABASE_ANON_KEY=<SUPABASE_ANON_KEY>' -e 'EKWO_PASSWORD=<EKWO_PASSWORD>' -e 'EKWO_ACCESS_TOKEN=<EKWO_ACCESS_TOKEN>' -e 'EKWO_DB_URL=<EKWO_DB_URL>' -- npx -y @ekwo-ai/mcp

Fill in your credentials
Replace <SUPABASE_ANON_KEY>, <EKWO_PASSWORD>, <EKWO_ACCESS_TOKEN>, <EKWO_DB_URL> with your real values. Keep secrets out of any config file you commit.
3
Verify it's connected
bash
```
claude mcp list
```
Sharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes. It discovers them automatically.

How to install Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres in Claude DesktopDesktop app (MCP config)

Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this server

json

{
  "mcpServers": {
    "ekwo": {
      "command": "npx",
      "args": [
        "-y",
        "@ekwo-ai/mcp"
      ],
      "env": {
        "SUPABASE_ANON_KEY": "<SUPABASE_ANON_KEY>",
        "EKWO_PASSWORD": "<EKWO_PASSWORD>",
        "EKWO_ACCESS_TOKEN": "<EKWO_ACCESS_TOKEN>",
        "EKWO_DB_URL": "<EKWO_DB_URL>"
      }
    }
  }
}

Fill in your credentials
Replace <SUPABASE_ANON_KEY>, <EKWO_PASSWORD>, <EKWO_ACCESS_TOKEN>, <EKWO_DB_URL> with your real values. Keep secrets out of any config file you commit.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.

How to install Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres in CursorAI-first code editor

Create / edit .cursor/mcp.json in your project

json

{
  "mcpServers": {
    "ekwo": {
      "command": "npx",
      "args": [
        "-y",
        "@ekwo-ai/mcp"
      ],
      "env": {
        "SUPABASE_ANON_KEY": "<SUPABASE_ANON_KEY>",
        "EKWO_PASSWORD": "<EKWO_PASSWORD>",
        "EKWO_ACCESS_TOKEN": "<EKWO_ACCESS_TOKEN>",
        "EKWO_DB_URL": "<EKWO_DB_URL>"
      }
    }
  }
}

Fill in your credentials
Replace <SUPABASE_ANON_KEY>, <EKWO_PASSWORD>, <EKWO_ACCESS_TOKEN>, <EKWO_DB_URL> with your real values. Keep secrets out of any config file you commit.
Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

How to install Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres in Codex CLIOpenAI coding agent

Add to ~/.codex/config.toml

toml

[mcp_servers.ekwo]
command = "npx"
args = ["-y", "@ekwo-ai/mcp"]
env = { SUPABASE_ANON_KEY = "<SUPABASE_ANON_KEY>", EKWO_PASSWORD = "<EKWO_PASSWORD>", EKWO_ACCESS_TOKEN = "<EKWO_ACCESS_TOKEN>", EKWO_DB_URL = "<EKWO_DB_URL>" }

Fill in your credentials
Replace <SUPABASE_ANON_KEY>, <EKWO_PASSWORD>, <EKWO_ACCESS_TOKEN>, <EKWO_DB_URL> with your real values. Keep secrets out of any config file you commit.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

How to install Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres in WindsurfCodeium's agentic IDE

Edit ~/.codeium/windsurf/mcp_config.json

json

{
  "mcpServers": {
    "ekwo": {
      "command": "npx",
      "args": [
        "-y",
        "@ekwo-ai/mcp"
      ],
      "env": {
        "SUPABASE_ANON_KEY": "<SUPABASE_ANON_KEY>",
        "EKWO_PASSWORD": "<EKWO_PASSWORD>",
        "EKWO_ACCESS_TOKEN": "<EKWO_ACCESS_TOKEN>",
        "EKWO_DB_URL": "<EKWO_DB_URL>"
      }
    }
  }
}

Fill in your credentials
Replace <SUPABASE_ANON_KEY>, <EKWO_PASSWORD>, <EKWO_ACCESS_TOKEN>, <EKWO_DB_URL> with your real values. Keep secrets out of any config file you commit.
Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

How to install Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres in ClineVS Code autonomous agent

Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.

Add the server

json

{
  "mcpServers": {
    "ekwo": {
      "command": "npx",
      "args": [
        "-y",
        "@ekwo-ai/mcp"
      ],
      "env": {
        "SUPABASE_ANON_KEY": "<SUPABASE_ANON_KEY>",
        "EKWO_PASSWORD": "<EKWO_PASSWORD>",
        "EKWO_ACCESS_TOKEN": "<EKWO_ACCESS_TOKEN>",
        "EKWO_DB_URL": "<EKWO_DB_URL>"
      }
    }
  }
}

Fill in your credentials
Replace <SUPABASE_ANON_KEY>, <EKWO_PASSWORD>, <EKWO_ACCESS_TOKEN>, <EKWO_DB_URL> with your real values. Keep secrets out of any config file you commit.

How to install Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres in VS CodeCopilot / MCP support

Create .vscode/mcp.json

json

{
  "servers": {
    "ekwo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ekwo-ai/mcp"
      ],
      "env": {
        "SUPABASE_ANON_KEY": "<SUPABASE_ANON_KEY>",
        "EKWO_PASSWORD": "<EKWO_PASSWORD>",
        "EKWO_ACCESS_TOKEN": "<EKWO_ACCESS_TOKEN>",
        "EKWO_DB_URL": "<EKWO_DB_URL>"
      }
    }
  }
}

Fill in your credentials
Replace <SUPABASE_ANON_KEY>, <EKWO_PASSWORD>, <EKWO_ACCESS_TOKEN>, <EKWO_DB_URL> with your real values. Keep secrets out of any config file you commit.
Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

What does Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres need from you?

API key — The anon (publishable) key. Never the service_role key: the server refuses it.

SUPABASE_URLoptionalEnvironment variable
https://<ref>.supabase.co of your own project
SUPABASE_ANON_KEYoptionalsecretEnvironment variable
The anon (publishable) key. Never the service_role key: the server refuses it.
EKWO_EMAILoptionalEnvironment variable
The user the agent acts as
EKWO_PASSWORDoptionalsecretEnvironment variable
That user's password
EKWO_ACCESS_TOKENoptionalsecretEnvironment variable
An access token, instead of email and password
EKWO_DB_URLoptionalsecretEnvironment variable
Direct Postgres connection, for a self-hosted database without PostgREST
EKWO_ACT_AS_USER_IDoptionalEnvironment variable
Required with EKWO_DB_URL: the auth.users id the server acts for
EKWO_EINVOICE_DIRECTORYoptionalEnvironment variable
Optional: the folder electronic invoices are sent to. Unset, they are issued and kept, and not sent
EKWO_AGENT_POSTINGoptionalEnvironment variable
Optional: autopilot or review, how this session posts documents. Unset, each company's agent_posting decides

Pass secrets through your shell environment rather than committing them into a config file.

What tools does Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres expose?

This server runs as a local package. We only query remote servers for their tool list — asking this one would mean executing it, so its tools are listed in the documentation below.

What the code can do

Read from the published package source — never executed. Parsed 16 of 16 source files.

This server can read your environment variables.

How it was published

Published by a verified CI identity (github trusted publishing) rather than a personal token.
Has a provenance attestation tying this artifact to the commit it was built from.
1 npm maintainer — a single point of compromise · last published by GitHub Actions.

Maintainer of this package and think something here is wrong? Tell us and we'll correct it.

Before you install

Signals gathered from the source repo and package registry — not a safety verdict.

What it can reach

Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
Downloads at launch — The package is fetched from its registry each run unless you pin a version.

Last commit today — Actively maintained.
Repository created 1 month ago — Very new project with little track record yet.
40 GitHub stars — Community adoption signal.
876 weekly downloads — Regularly installed by other developers.

Client compatibility

Claude Code: NativeClaude Desktop: NativeCursor: NativeCodex CLI: NativeWindsurf: NativeCline: NativeVS Code: Native

Health score

A · 87

Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated

Maintenance30%100%
Last commit 0 days ago.
Adoption20%59%
40 stars, 876 weekly downloads.
Transparency20%75%
3/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✗ discoverable tool list.
Provenance15%100%
Package and registry entry point at the same repository.
Packaging15%100%
Publishes a pinned version (0.23.0).

Documentation

Full README

Ekwo OS

Ekwo is open source accounting, ready to use on [Ekwo Cloud](https://cloud.ekwo.ai): the web application for your invoices, your bank statements, your VAT returns and the electronic invoices your country uses, in your own instance, with an account opened in a minute. Ekwo OS is the free and open source core it runs on, under AGPL-3.0: install it on your own Supabase project and own your accounting data, forever.

Built and maintained by Ekwo. Ekwo OS is a schema, the rules of each country as data, and the tools — a command line and an MCP server — with which you, your accountant and the AI agent you choose work in the same books, each with their own access. Ekwo reads any supplier invoice, in any language, with the AI model you choose, and every entry is posted on your confirmation. What Ekwo is, and its limits: DISCLAIMER.md.

*From an empty Supabase project to a prepared VAT return, for two countries side by side. How it was recorded: `docs/demo/`.*

Try it on your own books. Already using Claude? Start with Claude goes from a free Supabase project to your own books taken over, questioned and your next VAT return prepared, in about twenty minutes. Or open the same books in the web application, Ekwo Cloud.

Why Ekwo

The long version — financial autonomy for every business, accounting as a commons, a network rather than a vendor — is in MANIFESTO.md.

The data belongs to the business, and the work of keeping the books can be done by software the business also owns. So the whole accounting core is open, the data sits in a Postgres database you control, and the interface is designed for machines as much as for people. Supabase gives the schema a REST API for free, and an MCP server sits on top of it, so an AI agent can book a purchase, match a payment or prepare a VAT return on your own data — as you, under your own row level security, without the data leaving your account.

What ships today:

The core — schema, posting rules, taxes, reports, financial statements,

as migrations you apply to a database you control.

A country pack for every country listed below, each a versioned set of

data with a year of books that proves it.

Excerpt — the full document is on GitHub.

Alternatives to Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres

Maintain Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

markdown

[![Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/ai-ekwo-mcp)](https://mcp-skills-hub.vercel.app/mcps/ai-ekwo-mcp)

Catalog data refreshed Oct 27, 2026. Something wrong? Report it.