# `list_goals`

Lists your active goals, private ones included.

Annotations: `readOnlyHint: true` · `destructiveHint: false` · `idempotentHint: true` · `openWorldHint: false`

## When to use it

Start here for any request about "my goal". Ended goals aren't listed, and neither are other members' goals. Selected groups aren't included. Read them with [`get_goal`](/docs/mcp/tools/get_goal).

## Inputs

No inputs.

## Returns

`{ "goals": [...] }`, newest first. Each goal has:

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | Goal ID |
| `beneficiary` | object or null, optional | Fixed owner-scoped `{ personId, name }` when the goal is for someone in your Rolodex. Preserve this identity; such goals stay private. |
| `text` | string | The goal, as its selected groups read it |
| `additionalContext` | string | Your private details. Never repeat them where other members could read them. |
| `contextRevisionId` | string | The current private-details revision, needed for writes |
| `scopeVersion` | number | The current version, needed for writes |
| `clarificationQuestion` | string or null | A question Gravity asked about the goal. No search starts while one is open. |
| `suggestedByGravity` | boolean | Gravity wrote this goal and you haven't reworded it |
| `createdAt` | string | ISO 8601 timestamp |
| `retiredAt` | string or null | Always null here, since ended goals aren't listed |
| `isOwner` | boolean | Always true here |
| `memberId`, `ownerName`, `ownerImageUrl` | | The owner, which is you |

## Example

```json list_goals
{}
```

Result (synthetic data):

```json result:list_goals
{
  "goals": [
    {
      "id": "00000000-0000-4000-a000-000000000001",
      "memberId": "00000000-0000-4000-a000-000000000003",
      "beneficiary": null,
      "ownerName": "Synthetic member",
      "ownerImageUrl": null,
      "text": "Find design partners",
      "additionalContext": "Synthetic private details",
      "clarificationQuestion": null,
      "contextRevisionId": "00000000-0000-4000-a000-000000000002",
      "scopeVersion": 2,
      "suggestedByGravity": false,
      "retiredAt": null,
      "createdAt": "2026-10-09T00:00:00.000Z",
      "isOwner": true,
      "version": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  ]
}
```

## Related

- [`get_goal`](/docs/mcp/tools/get_goal) reads one goal with its audience and search state.
- [Goals and audiences](/docs/mcp/concepts/goals) explains private details and versions.