Money

FreeNot checked

MCP server for personal finance tracking, enabling expense/income recording, budget management, and financial summaries through 16 tools.

by castletaste

GitHub Embed

About

MCP server for personal finance tracking, enabling expense/income recording, budget management, and financial summaries through 16 tools.

README

MCP server for personal finance tracking. Designed for AI assistants — track expenses, income, budgets, and get financial summaries through 16 MCP tools.

Uses PostgreSQL with Drizzle ORM. Auto-migrates on startup.

Requirements

Bun runtime
PostgreSQL 14+

Installation

bunx mcp-money

Configuration

Add to your MCP client config (e.g. Claude Desktop):

{
  "mcpServers": {
    "money": {
      "command": "bunx",
      "args": ["mcp-money"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost:5432/mydb"
      }
    }
  }
}

Environment variables

Variable	Required	Default	Description
`DATABASE_URL`	Yes	—	PostgreSQL connection string
`MCP_MONEY_SCHEMA`	No	`mcp_money`	PostgreSQL schema name
`DEBUG`	No	`false`	Enable SQL query logging to stderr

Tools (16)

Transactions

Tool	Description
`add_transaction`	Record an expense or income. Expenses stored as negative amounts. Tags created on-the-fly.
`list_transactions`	List with filters: date range, category, tag, currency. Supports limit/offset pagination.
`update_transaction`	Partial update of any field including tags.
`delete_transaction`	Hard delete a transaction.

Tool	Description
`list_categories`	List all categories grouped by type (expense/income).
`create_category`	Create a category with name, type, optional parent (one nesting level).
`delete_category`	Delete a category. Fails if transactions, budgets, or child categories reference it.

Tool	Description
`list_tags`	List all tags.
`create_tag`	Create a tag with a unique name.
`delete_tag`	Delete a tag and all transaction associations (CASCADE).

Summary

Tool	Description
`get_summary`	Financial summary for a date range: expenses by category, totals and averages per currency.

Budgets

Tool	Description
`set_budget`	Set or update a monthly budget for a category.
`get_budget_status`	Check budget vs actual spending for a month. Multi-currency aware.
`delete_budget`	Delete a budget by ID.

Utilities

Tool	Description
`set_currency`	Set the default currency for new transactions (e.g. USD, EUR, RUB).
`health_check`	Check DB connection, schema version, and statistics.

Multi-currency

Every transaction stores its own currency. The default currency (initially USD) can be changed via set_currency. Summaries and budget statuses group by currency — no cross-currency conversion.

Default categories

On first run, ~10 categories are seeded: Groceries, Restaurants, Transport, Entertainment, Utilities, Rent, Salary, Healthcare, Shopping, Other.

Development

bun install
bun run dev        # watch mode
bun test           # run tests

Requires a running PostgreSQL instance. Set DATABASE_URL in .env.

License

ISC

from github.com/castletaste/money-mcp

Install Money in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install mcp-money

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add mcp-money -- npx -y mcp-money

FAQ

Is Money MCP free?

Yes, Money MCP is free — one-click install via Unyly at no cost.

Does Money need an API key?

No, Money runs without API keys or environment variables.

Is Money hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Money in Claude Desktop, Claude Code or Cursor?

Open Money on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Stripe

Payments, customers, subscriptions

by Stripe

malamutemayhem/unclick-agent-native-endpoints

110+ tools for AI agents spanning social media, finance, gaming, music, AU-specific services, and utilities. Zero-config local tools plus platform connectors. n

by malamutemayhem

whiteknightonhorse/APIbase

Unified API hub for AI agents with 56+ tools across travel (Amadeus, Sabre), prediction markets (Polymarket), crypto, and weather. Pay-per-call via x402 micropa

by whiteknightonhorse

trackerfitness729-jpg/sitelauncher-mcp-server

Deploy live HTTPS websites in seconds. Instant subdomains ($1 USDC) or custom .xyz domains ($10 USDC) on Base chain. Templates for crypto tokens and AI agent pr

by trackerfitness729-jpg

Compare Money with

MoneyvsStripe Moneyvsmalamutemayhem/unclick-agent-native-endpoints Moneyvswhiteknightonhorse/APIbase Moneyvstrackerfitness729-jpg/sitelauncher-mcp-server

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All finance MCPs