Expense MCP

Personal Expense Tracker MCP Server — expenses, income, budgets & savings goals

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "expense-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "expense-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

💰 expense-mcp

Personal Expense Tracker as an MCP Server — works with Claude Desktop, Cursor, nanobot, Windsurf, and any MCP-compatible client.

Features

📝 Track expenses & income with categories and descriptions
📊 Spending summaries — today, week, month, year
💳 Budget management — set limits per category, get alerts at 80%/100%
🎯 Savings goals — create goals, track progress with visual bars
📈 Spending insights — top categories, daily averages, biggest days
🗑️ Safe deletion — Pydantic-based elicitation for confirmation
🔄 Dual transport — stdio (local) + streamable HTTP (remote)

Install

bash

# with uv (recommended)
uv pip install git+https://github.com/justfsl50/expense-mcp.git

# with pip
pip install git+https://github.com/justfsl50/expense-mcp.git

# from source
git clone https://github.com/justfsl50/expense-mcp.git
cd expense-mcp
pip install -e .

Quick Start

Claude Desktop

Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac):

config.json

{
  "mcpServers": {
    "expense-mcp": {
      "command": "uv",
      "args": ["run", "expense-mcp"],
      "env": {
        "DATABASE_URL": "sqlite:///expenses.db",
        "CURRENCY": "₹",
        "DEFAULT_USER": "me"
      }
    }
  }
}

Cursor / Windsurf

Same config — paste into MCP settings under the respective app.

nanobot

config.json

{
  "mcp": {
    "servers": [{
      "name": "expense-mcp",
      "command": "uv run expense-mcp"
    }]
  }
}

HTTP mode (remote / multi-client)

bash

python server.py http
# Server runs at http://127.0.0.1:8000/mcp

Environment Variables

Variable	Default	Description
`DATABASE_URL`	`sqlite:///expenses.db`	SQLite or PostgreSQL URL
`CURRENCY`	`₹`	Currency symbol
`DEFAULT_USER`	`default`	User ID for multi-user setups

PostgreSQL example:

Code

DATABASE_URL=postgresql://user:pass@localhost:5432/expenses

Tools

Tool	Description	Read-only
`expense_add`	Save expense or income	❌
`expense_search`	Filter by text, date, category, amount	✅
`expense_summary`	today / week / month / year totals	✅
`expense_delete`	Delete with Pydantic confirmation prompt	❌
`expense_insights`	Spending patterns and top categories	✅
`budget_set`	Set monthly category budget	❌
`budget_list`	View budgets with usage %	✅
`goal_create`	Create savings goal	❌
`goal_update`	Add money toward goal	❌
`goal_list`	View goals with progress bars	✅

Resources

URI	Description
`expense://summary/month`	Current month summary
`expense://budgets/current`	This month's budgets
`expense://goals/all`	All savings goals

Prompts

Prompt	Title	Description
`monthly_review`	Monthly Review	Start a full month spending review
`budget_setup`	Budget Setup	Auto-suggest budgets from history
`savings_plan`	Savings Plan	Create a plan for a savings goal

Usage Examples

Just talk naturally in any MCP client:

Code

"spent 500 on groceries"
"show food expenses this week"
"how much did I spend last month?"
"set food budget to 5000"
"am I within budget?"
"save 1000 toward my iPhone goal"
"give me spending insights"
"delete expense #12"

Architecture

MCP SDK v1.26.0 with FastMCP + json_response=True
Typed lifespan — DB engine managed via AppContext dataclass
SQLAlchemy 2.0 — DeclarativeBase, sessionmaker
Pydantic v2 — input validation, elicitation schemas
Tool annotations — readOnlyHint, destructiveHint, idempotentHint
Context logging — ctx.info(), ctx.warning() in tools

Database Schema

Code

expenses  — id, user_id, amount, category, description, type, date, source, created_at
budgets   — id, user_id, category, amount, month
goals     — id, user_id, name, target, saved, deadline

License

MIT — free to use, modify, and distribute.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Expense MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "expense-mcp": { "command": "npx", "args": ["-y", "expense-mcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/expense-mcp?style=directory)](https://allmcps.com/mcp/expense-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/expense-mcp"><img src="https://allmcps.com/api/badge/expense-mcp?style=directory" alt="Expense MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Expense MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Expense MCP

Personal Expense Tracker MCP Server — expenses, income, budgets & savings goals

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "expense-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "expense-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

💰 expense-mcp

Personal Expense Tracker as an MCP Server — works with Claude Desktop, Cursor, nanobot, Windsurf, and any MCP-compatible client.

Features

📝 Track expenses & income with categories and descriptions
📊 Spending summaries — today, week, month, year
💳 Budget management — set limits per category, get alerts at 80%/100%
🎯 Savings goals — create goals, track progress with visual bars
📈 Spending insights — top categories, daily averages, biggest days
🗑️ Safe deletion — Pydantic-based elicitation for confirmation
🔄 Dual transport — stdio (local) + streamable HTTP (remote)

Install

bash

# with uv (recommended)
uv pip install git+https://github.com/justfsl50/expense-mcp.git

# with pip
pip install git+https://github.com/justfsl50/expense-mcp.git

# from source
git clone https://github.com/justfsl50/expense-mcp.git
cd expense-mcp
pip install -e .

Quick Start

Claude Desktop

Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac):

config.json

{
  "mcpServers": {
    "expense-mcp": {
      "command": "uv",
      "args": ["run", "expense-mcp"],
      "env": {
        "DATABASE_URL": "sqlite:///expenses.db",
        "CURRENCY": "₹",
        "DEFAULT_USER": "me"
      }
    }
  }
}

Cursor / Windsurf

Same config — paste into MCP settings under the respective app.

nanobot

config.json

{
  "mcp": {
    "servers": [{
      "name": "expense-mcp",
      "command": "uv run expense-mcp"
    }]
  }
}

HTTP mode (remote / multi-client)

bash

python server.py http
# Server runs at http://127.0.0.1:8000/mcp

Environment Variables

Variable	Default	Description
`DATABASE_URL`	`sqlite:///expenses.db`	SQLite or PostgreSQL URL
`CURRENCY`	`₹`	Currency symbol
`DEFAULT_USER`	`default`	User ID for multi-user setups

PostgreSQL example:

Code

DATABASE_URL=postgresql://user:pass@localhost:5432/expenses

Tools

Tool	Description	Read-only
`expense_add`	Save expense or income	❌
`expense_search`	Filter by text, date, category, amount	✅
`expense_summary`	today / week / month / year totals	✅
`expense_delete`	Delete with Pydantic confirmation prompt	❌
`expense_insights`	Spending patterns and top categories	✅
`budget_set`	Set monthly category budget	❌
`budget_list`	View budgets with usage %	✅
`goal_create`	Create savings goal	❌
`goal_update`	Add money toward goal	❌
`goal_list`	View goals with progress bars	✅

Resources

URI	Description
`expense://summary/month`	Current month summary
`expense://budgets/current`	This month's budgets
`expense://goals/all`	All savings goals

Prompts

Prompt	Title	Description
`monthly_review`	Monthly Review	Start a full month spending review
`budget_setup`	Budget Setup	Auto-suggest budgets from history
`savings_plan`	Savings Plan	Create a plan for a savings goal

Usage Examples

Just talk naturally in any MCP client:

Code

"spent 500 on groceries"
"show food expenses this week"
"how much did I spend last month?"
"set food budget to 5000"
"am I within budget?"
"save 1000 toward my iPhone goal"
"give me spending insights"
"delete expense #12"

Architecture

MCP SDK v1.26.0 with FastMCP + json_response=True
Typed lifespan — DB engine managed via AppContext dataclass
SQLAlchemy 2.0 — DeclarativeBase, sessionmaker
Pydantic v2 — input validation, elicitation schemas
Tool annotations — readOnlyHint, destructiveHint, idempotentHint
Context logging — ctx.info(), ctx.warning() in tools

Database Schema

Code

expenses  — id, user_id, amount, category, description, type, date, source, created_at
budgets   — id, user_id, category, amount, month
goals     — id, user_id, name, target, saved, deadline

License

MIT — free to use, modify, and distribute.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Expense MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "expense-mcp": { "command": "npx", "args": ["-y", "expense-mcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/expense-mcp?style=directory)](https://allmcps.com/mcp/expense-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/expense-mcp"><img src="https://allmcps.com/api/badge/expense-mcp?style=directory" alt="Expense MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

★ Featured

AllMCPs Server

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Expense MCP →Install in Claude Desktop Install in Cursor Install in VS Code