createCustomCategories
Create new custom categories for transactions.
LABSCO SUMMARY
Skip and mark-done as separate calls from edit and delete is the detail that shows this models recurring spending correctly.
A recurring transaction is a rule plus a series of instances, and most implementations only expose the rule — so a month where the subscription did not charge leaves you editing the rule or deleting a real record. Having a per-period skip and a per-period completion keeps the rule intact while recording what actually happened. The instruction on getCategoriesByType is the other useful bit of discipline: telling the caller to fetch valid category names rather than invent one is how a logged transaction ends up in the right place rather than in a category that quietly does not exist.
What it is
A personal finance client covering three areas: individual transactions, recurring ones with per-period control, and budgets against categories.
What you get
- Transactions with a full lifecycle — retrieve, create, edit and delete, with delete stated as permanent.
- Categories in two kinds: getCategoriesByType is named as the way to get valid category names, and custom categories can be created and removed.
- Recurring transactions handled the way they actually behave — markRecurringTransactionDone for this period and skipRecurringTransaction for the month it did not happen, separate from editing or deleting the recurrence itself.
- Budgets set against categories for a period and read back.
- Currency preference read and set.
Requirements
BUDGETSCO_ACCESS_TOKEN.
Setup effort
One command plus a key — npx @budgetsco/mcp, then supply credentials
USE CASES
01
Logging a purchase as you make it
Fetch the valid categories first, then create the transaction against a real one rather than a plausible name.
02
Reviewing where the money went
Retrieve transactions for the period and check them against the budget you set for those categories.
03
Handling a month that did not go to plan
Skip the recurring charge that did not happen, or mark one done, without editing the recurrence rule itself.
04
Setting up something that repeats
Create the recurring transaction, and edit or delete it when the arrangement changes.
05
Organising your own way
Create the custom categories you actually use and remove the ones you do not.
18 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
createRecurringTransaction
Create a recurring transaction
createTransaction
Create new transaction.
deleteCustomCategories
Delete custom categories
deleteRecurringTransaction
Delete a recurring transaction permanently
deleteTransaction
Delete transaction permanently.
editRecurringTransaction
Edit a recurring transaction
editTransaction
Edit an existing transaction.
getBudget
Retrieve budget for a specific period
getCategoriesByType
Retrieve all categories of a specific type. Always use this tool to get categories before creating a transaction. If no categories match, create a new category.
getCurrency
Get the current currency preference
getCustomCategories
Retrieve all custom categories created by the user
getRecurringTransactions
Retrieve recurring transactions
getTransactions
Retrieve a list of transactions
markRecurringTransactionDone
Mark a recurring transaction as done for the current period
setBudget
Set budget for categories
setCurrency
Set currency preference
skipRecurringTransaction
Skip a recurring transaction for the current period
BEFORE YOU INSTALL
What to know first
Tools you get
18 tools when we connected.
Requires
- npx on PATH
- Node.js
- BUDGETSCO_ACCESS_TOKEN in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Moderate Standing cost
Rated by the size of the 18 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx @budgetsco/mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"budgetsco": {
"command": "npx",
"args": [
"@budgetsco/mcp"
],
"env": {
"BUDGETSCO_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}
