MCP.Market

Expense MCP server

by justfsl50·io.github.justfsl50/expense-mcp·v1.0.1·1 stars
No reviews yet

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

B75/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B75/100

full report

Adoption
New

1 stars16 downloads/wk

Reviews

Write one

Nobody has reviewed Expense yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Expense tools (10, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • budget_list

    Get all budgets and current spending for this month.

  • budget_set

    Set or update a monthly budget for a spending category.

  • expense_add

    Save a new expense or income transaction.

  • expense_deletewrite action

    Permanently delete an expense by ID. Asks for confirmation first.

  • expense_insights

    Get spending patterns and insights for the current month.

  • expense_search

    Search and filter expenses with flexible criteria.

  • expense_summary

    Get spending summary for a time period.

  • goal_createwrite action

    Create a new savings goal.

  • goal_list

    Get all savings goals with progress bars.

  • goal_updatewrite action

    Add money toward a savings goal.

Public scan report

scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it

no findings
  • Code scan3 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 208 days ago4/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 75/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Expense compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
75/100
higher than 45% of 48,255 servers
Tools
10
the typical server has 7
Tools that change things
30%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 65% of 28,688 servers
Downloads a week
16
more than 4% of 12,191 servers with a package

What its tools let an agent do: 7 read · 3 change

Install Expense in Claude Code, Cursor or VS Code

claude mcp add expense-mcp -- uvx expense-mcp
Add to Cursor

What the publisher says

From the Expense repository's README, as published. We do not edit it. Read it on GitHub

💰 expense-mcp

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

<!-- mcp-name: io.github.justfsl50/expense-mcp -->

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

# 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\claudedesktopconfig.json (Windows) or ~/Library/Application Support/Claude/claudedesktopconfig.json (Mac):

{
  "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

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

HTTP mode (remote / multi-client)

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

Environment Variables

PostgreSQL example:

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

Tools

Resources

Prompts

Usage Examples

Just talk naturally in any MCP client:

"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

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Expense: common questions

Is Expense MCP server safe?
Mostly: it is graded B (75/100). Read the Expense safety report
How do I install Expense?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Expense need an API key?
No secret keys are declared. It reads 3 settings from the environment.
Is Expense maintained?
The last commit was 245 days ago (2026-03-04). The latest release is v1.0.1.
How does Expense compare with other MCP servers?
safety score 75/100 (higher than 45% of 48,255 servers); tools 10 (the typical server has 7); tools that change things 30% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.