Skip to main content
Cash flow categories are the organization’s chart of categories for classifying money in and out. They form a two-level tree: top-level categories carry a direction (inflow or outflow) and hold nested subcategories. The MCP server lets you read the catalog, add to it, and set or clear the category on transactions. The category and subcategory ids surfaced here are the same ones returned as cashflow_category.id and cashflow_subcategory.id on a transaction (see Transactions and statements), so they reconcile against an external chart of accounts.

​
Tools

ToolWhat it doesUpstream
list_cash_flow_categoriesRead the catalog as a tree: each parent category, its direction, VAT rate, and nested subcategories. Read-only. Use it to resolve a category_id before assigning, and to map the ids seen on transactions back to names.List cash flow categories
create_cash_flow_categoryGrow the catalog. Omit parent_category_id to create a top-level category — a direction type (CATEGORY_TYPE_INFLOW or CATEGORY_TYPE_OUTFLOW) is required. Pass parent_category_id to create a subcategory under it — type is rejected there, since a subcategory inherits its parent’s direction.Create a cash flow category · Create a cash flow subcategory
modify_transaction_cash_flow_categorySet or clear the cash flow category on up to 100 transactions in one call. Pick exactly one branch: assign (transaction_ids + category_id) tags the transactions, replacing any category they already carry; clear (transaction_ids) removes whatever category they carry.Assign a cash flow category to transactions · Unassign a cash flow category from transactions

​
Assigning to a leaf

A transaction is categorized against a single node in the tree. Once a category has subcategories, assignment must target a leaf subcategory — assigning the parent is rejected. Resolve the right category_id with list_cash_flow_categories, then pass it (the subcategory id, when one exists) to modify_transaction_cash_flow_category with the assign branch. clear is its own branch rather than an assign with an empty category_id, so removing a category is always explicit and a tagging call can never silently wipe one. Try it
What cash flow categories do I have set up? Create an outflow category “Software” with a “Cloud hosting” subcategory under it. Tag my last three AWS transactions as Cloud hosting. Clear the cash flow category on that miscategorized transfer.