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#
| Parameter | Type | Required | Description |
|---|---|---|---|
goal_id | string | Yes | UUID of the goal to update (required). Use goals_list to find. · Format: UUID |
name | string | No | Updated goal name (max 200 characters) |
description | string | No | Updated description (max 4000 characters) |
unit_label | string | No | Updated unit label (max 24 characters) |
target_value | number | No | Updated target number · Min: 0.01 |
current_value | number | No | Updated current value. ONLY valid on a metric="manual" goal. · Min: 0 |
period_type | enum | No | Updated period length · One of: weekly, monthly, quarterly, annually, custom |
period_start | string | No | Updated first day of the period (YYYY-MM-DD) (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
period_end | string | No | Updated last day of the period (YYYY-MM-DD) (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
status | enum | No | Updated 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.