Projects

update-budget-tool

Update fields on an existing budget. The parent project cannot be reassigned.

Updates the whitelisted fields below on a budget. Reassigning the budget to a different project is not supported through MCP.

Inputs

NameTypeRequiredDescription
idintegeryesBudget id.
descriptionstringnoBudget description (max 255).
budgetinteger (minutes)noBudget value, ≥0.
spendableinteger (minutes)noSpendable value, ≥0.
start_datestring (Y-m-d) | nullnoStart date, or null to clear.
end_datestring (Y-m-d) | nullnoEnd date, or null to clear. Must be on or after start_date.
statusstringnoOne of active, inactive, blocked.
is_openbooleannoOpen/closed flag.
is_billablebooleannoBillable flag.
budget_group_idinteger | nullnoBudget group id, or null to clear.

Permissions

  • budgets::update.

Example

{
  "id": 31,
  "budget": 3600,
  "is_billable": false
}

Response

The updated budget, in the same shape as a row from list-budgets-tool.

Errors

  • An invalid status value returns a validation error.
  • A non-existent id returns a 404-style error.
  • Missing budgets::update returns an authorization error.

On this page