Skip to content
MCP tools
Updates dataGoalsMCP tool

goals_update

Update an existing goal's name, description, target, period, or status.

Last updated

Update an existing goal's name, description, target, period, or status. Only provided fields change — omitted fields stay unchanged. Use status="achieved" when the goal is met, "missed" when the period ended short, or "paused" to set it aside. current_value is writable ONLY on a metric="manual" goal. A goal's assignment (who it belongs to) is write-once and cannot be changed here. Returns the updated goal.

Parameters#

ParameterTypeRequiredDescription
goal_idstringYesUUID of the goal to update (required). Use goals_list to find. · Format: UUID
namestringNoUpdated goal name (max 200 characters)
descriptionstringNoUpdated description (max 4000 characters)
unit_labelstringNoUpdated unit label (max 24 characters)
target_valuenumberNoUpdated target number · Min: 0.01
current_valuenumberNoUpdated current value. ONLY valid on a metric="manual" goal. · Min: 0
period_typeenumNoUpdated period length · One of: weekly, monthly, quarterly, annually, custom
period_startstringNoUpdated first day of the period (YYYY-MM-DD) (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD)
period_endstringNoUpdated last day of the period (YYYY-MM-DD) (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD)
statusenumNoUpdated status · One of: active, paused, achieved, missed

Example prompts#

  • "Mark my September listings goal as achieved."
  • "Raise my Q4 closings target from 12 to 15."

Safety#

Updates data. Changes an existing record. The change is visible immediately in the app and can be edited back.