Skip to content
appsgit

Ekwo OS — open source accounting: ledger, invoices and VAT o

Ekwo OS — open source accounting: ledger, invoices and VAT o is an MCP server that adds finance tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Double-entry books an agent keeps as the user: invoices, VAT… It has 40 GitHub stars, is released under the AGPL-3.0 license and runs locally with npx -y @ekwo-ai/mcp.

github.com/Ekwo-ai/ekwo-os (opens in a new tab)

Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error

View on GitHub (opens in a new tab)Website (opens in a new tab)

Install Ekwo OS — open source accounting: ledger, invoices and VAT o

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "ekwo-os-open-source-accounting-ledger-invoices-and-vat-o": {
      "command": "npx",
      "args": [
        "-y",
        "@ekwo-ai/mcp"
      ],
      "env": {
        "SUPABASE_ANON_KEY": "your-value",
        "EKWO_PASSWORD": "your-value",
        "EKWO_ACCESS_TOKEN": "your-value",
        "EKWO_DB_URL": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env SUPABASE_ANON_KEY=your-value --env EKWO_PASSWORD=your-value --env EKWO_ACCESS_TOKEN=your-value --env EKWO_DB_URL=your-value --transport stdio ekwo-os-open-source-accounting-ledger-invoices-and-vat-o -- npx -y @ekwo-ai/mcp

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "ekwo-os-open-source-accounting-ledger-invoices-and-vat-o": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ekwo-ai/mcp"
      ],
      "env": {
        "SUPABASE_ANON_KEY": "your-value",
        "EKWO_PASSWORD": "your-value",
        "EKWO_ACCESS_TOKEN": "your-value",
        "EKWO_DB_URL": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "supabase_anon_key",
      "description": "SUPABASE_ANON_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "ekwo_password",
      "description": "EKWO_PASSWORD",
      "password": true
    },
    {
      "type": "promptString",
      "id": "ekwo_access_token",
      "description": "EKWO_ACCESS_TOKEN",
      "password": true
    },
    {
      "type": "promptString",
      "id": "ekwo_db_url",
      "description": "EKWO_DB_URL",
      "password": true
    }
  ],
  "servers": {
    "ekwo-os-open-source-accounting-ledger-invoices-and-vat-o": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ekwo-ai/mcp"
      ],
      "env": {
        "SUPABASE_ANON_KEY": "${input:supabase_anon_key}",
        "EKWO_PASSWORD": "${input:ekwo_password}",
        "EKWO_ACCESS_TOKEN": "${input:ekwo_access_token}",
        "EKWO_DB_URL": "${input:ekwo_db_url}"
      }
    }
  }
}

Claude Code (remote)

claude mcp add --transport http ekwo-os-open-source-accounting-ledger-invoices-and-vat-o "https://mcp.ekwo.ai/mcp"

The same server is also hosted as a remote MCP endpoint, so nothing runs on your machine.

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
SUPABASE_URLNohttps://.supabase.co of your own project
SUPABASE_ANON_KEYsecretNoThe anon (publishable) key. Never the service_role key: the server refuses it.
EKWO_EMAILNoThe user the agent acts as
EKWO_PASSWORDsecretNoThat user's password
EKWO_ACCESS_TOKENsecretNoAn access token, instead of email and password
EKWO_DB_URLsecretNoDirect Postgres connection, for a self-hosted database without PostgREST
EKWO_ACT_AS_USER_IDNoRequired with EKWODBURL: the auth.users id the server acts for
EKWO_EINVOICE_DIRECTORYNoOptional: the folder electronic invoices are sent to. Unset, they are issued and kept, and not sent

About Ekwo OS — open source accounting: ledger, invoices and VAT o

The Model Context Protocol server for Ekwo OS. It lets an AI agent work on the books in your own Postgres: read the ledger, raise an invoice, post it, match a payment, prepare the VAT return — as you, under the row level security of your own installation.

  • accounting
  • agpl
  • bookkeeping
  • double-entry
  • factur-x
  • fec
  • mcp
  • open-source
  • postgres
  • supabase

Similar MCP servers

More finance MCP servers

All Finance

FAQ

Ekwo OS — open source accounting: ledger, invoices and VAT o FAQ

Still curious? Email info@appsgit.com.

How do I install the Ekwo OS — open source accounting: ledger, invoices and VAT o MCP server?

Add the command npx -y @ekwo-ai/mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Ekwo OS — open source accounting: ledger, invoices and VAT o free?

The server is open source under the AGPL-3.0 license, so running it is free. It needs credentials (SUPABASE_ANON_KEY, EKWO_PASSWORD, EKWO_ACCESS_TOKEN and EKWO_DB_URL) for the service it connects to, which may require a paid account.

Is Ekwo OS — open source accounting: ledger, invoices and VAT o actively maintained?

The most recent commit was on Oct 26, 2026. The latest release is v0.16.0, published Oct 19, 2026. appsgit only lists MCP servers with a commit in the last six months.