Expense Mcp

Name: Expense Mcp
Author: justfsl50

by justfsl50communityv1.0.1

The expense-mcp server is a personal expense tracker that allows users to manage their expenses and income, set budgets, and track savings goals through an MCP-compatible client.

From the registry: Personal Expense Tracker MCP Server — expenses, income, budgets & savings goals

GitHub Repository

Install & configure

Prerequisites

required
Install expense-mcp
Install from the GitHub source
```
$ uv pip install git+https://github.com/justfsl50/expense-mcp.git
```
https://github.com/justfsl50/expense-mcp

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `expense-mcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install expense-mcp** — Install from the GitHub source Run: `uv pip install git+https://github.com/justfsl50/expense-mcp.git` (https://github.com/justfsl50/expense-mcp)

Canonical MCP server config (stdio transport):
- command: `uv`
- args: ["run","expense-mcp"]
- optional environment variables:
  - `DATABASE_URL`: SQLite or PostgreSQL URL (example: `sqlite:///expenses.db`)
  - `CURRENCY`: Currency symbol (example: `USD`)
  - `DEFAULT_USER`: User ID for multi-user setups (example: `default`)

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Tools (10)

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

Environment variables

DATABASE_URLrequiredSQLite or PostgreSQL URL

Packages

expense-mcp

pypiv1.0.1transport: stdio

Details

Language: Python
License: MIT
Released: Mar 4, 2026
Last commit: Mar 4, 2026
Registry name: io.github.justfsl50/expense-mcp

Related Servers

Edgartools

Open-source SEC EDGAR toolkit — 11 tools, 7 prompts, every filing type. No API key required.

2.6k

edgar.tools SEC Intelligence

SEC filing intelligence — insider sentiment, material events, financial ratios, disclosure search.