mcpField
B
budget

budget

Local
github.com/theluckystrikeFinance2Updated 1d ago
Repository

About budget

budget is an MCP server for setting monthly category limits, recording spending, and checking what remains. It keeps a simple session ledger on the local machine without bank connections or finance-app logins.

Key features

  1. 01Set monthly category caps
  2. 02Record spending by category
  3. 03View caps, spending, and remaining amounts
  4. 04Identify over-budget categories
  5. 05Keep ledger data local

Use cases

  1. 01Check remaining grocery funds after a purchase
  2. 02Compare transport spending with its monthly limit
  3. 03Review categories that have exceeded their caps

MCP support

Exposes `budget_set`, `budget_spend`, and `budget_report` tools to MCP clients for managing and reviewing a local budget ledger.

Configuration

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

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository
Packages
mcpbbudget.mcpb0.22.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MCP Budget — monthly budgets you set and check inside the conversation

Give Claude (or any MCP client) a real envelope budget: budget_set to declare a category and its monthly cap, budget_spend to record spending against it, budget_report to see every category with how much is left. All of it in chat, all of it on your machine, no finance app login and no bank connection.

Why a budget server

Budget apps want your bank credentials, a subscription, and the discipline to open them. This one asks for none of that. It keeps a simple in-memory ledger for the session: you say "groceries 400" and "spend 62 on groceries", and the report tells you what remains. It is the fastest possible loop between "can I afford this?" and an answer.

What it does

  • budget_set — set a monthly cap for a category (groceries, transport, eating out — any name you use).
  • budget_spend — record an amount against a category; the server rejects nothing and judges nothing, it just does the arithmetic.
  • budget_report — one table: category, cap, spent, remaining. Over-budget categories are visible at a glance.

Install

{
  "mcpServers": {
    "mcp-budget": {
      "command": "npx",
      "args": ["-y", "github:theluckystrike/mcp-budget"]
    }
  }
}

Try it

  • "Set a 400 monthly grocery budget and log 62 spent today."
  • "I spent 30 on transport and 18 on coffee — show my budget report."
  • "Which categories am I over on?"

Part of the luckystrike MCP suite

Free, part of the luckystrike MCP suite — productivity & finance servers that turn AI chat into working documents and calculations. Listing in the official MCP Registry.

Docs (GitMCP)

Live docs endpoint: https://gitmcp.io/theluckystrike/mcp-budget

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.