goals_list
Search the caller's goals (KPI targets like "12 closings this quarter" or "get my first subscriber").
Last updated
Search the caller's goals (KPI targets like "12 closings this quarter" or "get my first subscriber"). Returns pagination info (total_count, has_more, offset, limit). Each result includes: id, name, metric, target_value, period_type, period_start, period_end, status, accent, created_at, plus plan progress (plan_done, plan_total, plan_pct) counted from the goal's milestones.
Note
for the five derived metrics (closings, gci, lead_conversions, appointments, listings_taken) the CURRENT metric value is calculated live by the web app from escrows/leads/appointments/listings and is deliberately NOT returned here — plan progress is. current_value is returned only for metric="manual", where the owner sets the number. Filter by status, metric, or period_type. For one goal plus its milestones, use goals_get.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Search term — matches against goal name and description (case-insensitive partial match) |
status | enum | No | Filter by status (default: all) · One of: all, active, paused, achieved, missed |
metric | enum | No | Filter by the metric the goal targets · One of: closings, gci, lead_conversions, appointments, listings_taken, manual |
period_type | enum | No | Filter by period length · One of: weekly, monthly, quarterly, annually, custom |
limit | number | No | Maximum results (default: 50, max: 500) · Max: 500 · Min: 1 |
offset | number | No | Skip N results for pagination (default: 0) · Min: 0 |
Example prompts#
- "What goals am I working on this quarter?"
- "Show me my paused goals."
Safety#
Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.