Budget

io.github.theluckystrikePublished by GitHub account theluckystrikev1.0.0Updated Oct 24, 2026

Set monthly budget categories, log spending, get over/under-budget reports. All data is local.

VerifiedSTDIODesktop onlyProductivity & WorkflowFinance

Overview

AI-generated overview

A local MCP server that keeps a simple envelope budget in the conversation: set monthly category caps, log spending, and get over/under reports.

What you can do
  • Set a monthly spending cap for any named category
  • Record spending amounts against a category
  • Show a report of category, cap, spent and remaining, flagging over-budget categories
When to use it
Useful when you want a quick in-chat check of whether a purchase fits a monthly budget, without a finance app, bank connection or account. Best for lightweight, session-level arithmetic rather than long-term bookkeeping.
Requirements
Runs as a local process on the user's machine (stdio); the README shows launching it with npx from a GitHub repository. No authentication, environment variables or headers are declared. Desktop client only.
Before you install
The ledger is in-memory for the session, so budget data is not persisted and is lost when the session ends. It records amounts only and does not connect to banks or verify transactions, so figures are only as accurate as what is entered.

Installation

In SourceWeft

  1. Open Budget in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

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

Source: servers/budget/README.md at commit 1bd9d69

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 27, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts