mcpField
M
Monexa

Monexa

Local
monexa.worldFinance0Updated 2w ago
RepositoryVisit website

About Monexa

Monexa is a personal finance and expense-tracking application built with a Go backend and React frontend. Its stated focus includes multi-currency support; the README describes local development and deployment setup.

Key features

  1. 01Personal finance tracking
  2. 02Expense tracking
  3. 03Multi-currency support
  4. 04Go backend and React frontend

Use cases

  1. 01Track personal expenses
  2. 02Manage finances involving multiple currencies
#finance#expense-tracker#personal-finance#multi-currency#budgeting

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "monexa": {
      "command": "npx",
      "args": [
        "-y",
        "monexa-mcp-server"
      ],
      "env": {
        "MONEXA_EMAIL": "<MONEXA_EMAIL>",
        "MONEXA_PASSWORD": "<MONEXA_PASSWORD>"
      }
    }
  }
}
Run commandnpx -y monexa-mcp-server
Environment variables to set
MONEXA_EMAIL
MONEXA_PASSWORDSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmonexa-mcp-server

Tools

21

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
emailstringYesAccount email address
passwordstringYesAccount password

Details

From the project README

Monexa

Personal finance and expense tracking app with multi-currency support. Go backend + React frontend.

What you need

mise install picks up both tool versions from mise.toml.

Development setup

The database runs in Docker; backend and frontend run on your machine for hot reload.

1. Environment variables

cp .env.example .env
cp frontend/.env.example frontend/.env

The example values work as-is locally. .env files are git-ignored; never commit real secrets.

2. Start the database

docker compose up -d

PostgreSQL listens on localhost:5433 (postgres / postgres, database monexa). If you used the previous compose file, run docker compose down --remove-orphans once to retire the old psql_monexa container.

3. Run the backend

go run ./cmd/api

The API listens on http://localhost:9000 (PORT in .env). Migrations run on startup.

4. Run the frontend

cd frontend
npm ci
npm run dev

Open http://localhost:5173.

Everything in Docker

Builds the same images that production uses and runs them next to Postgres (needs .env from step 1):

docker compose --profile app up --build

UI on http://localhost:3000, API on http://localhost:9000.

Tests

go test ./...
cd frontend && npm run lint

Deployment

See docs/DEPLOYMENT.md.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.