# 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. Open-source accounting MCP server: ledgers, invoices and VAT on your own Postgres. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Self-hosted
- **Website:** https://ekwo.ai
- **Repository:** https://github.com/ekwo-ai/ekwo-os/tree/HEAD/packages/mcp
- **MCP Registry name:** ai.ekwo/mcp
- **Categories:** [databases](https://ai-powered.com/categories/databases), [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.ekwo.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.ekwo.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.ekwo.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.ekwo.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.ekwo.ai/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.ekwo.ai/mcp"
    }
  }
}
```

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

## Alternatives

- [Aikount MCP](https://ai-powered.com/mcp/aikount-mcp): Aikount MCP is a freemium MCP server for finance and payments.
- [DIY Accounting Submit](https://ai-powered.com/mcp/diy-accounting-submit): DIY Accounting Submit is a paid MCP server for finance and payments.
- [bokio-mcp](https://ai-powered.com/mcp/bokio-mcp): bokio-mcp is an open-source MCP server for finance and payments.
- [AUTOPILOT](https://ai-powered.com/mcp/autopilot): AUTOPILOT is a freemium MCP server for finance and payments.
- [Sevdesk MCP](https://ai-powered.com/mcp/sevdesk-mcp): Sevdesk MCP is a free MCP server for finance and payments.
- [AccountsOS](https://ai-powered.com/mcp/accountsos): AccountsOS is an MCP server for finance and payments.
- [Benethos Lexware Office MCP](https://ai-powered.com/mcp/benethos-lexware-office-mcp): Benethos Lexware Office MCP is an open-source MCP server for finance and payments.
- [Economico](https://ai-powered.com/mcp/economico): Economico is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/ekwo-os-open-source-accounting-ledger-invoices-and-vat-on-yo
