# `list_group_goals`

Read a page of active goals visible within a group. Reading changes nothing and starts no search.

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

## Inputs

| Field | Required | Type | Meaning |
| --- | --- | --- | --- |
| `groupPublicId` | yes | string | Exact group public ID: 32 lowercase hexadecimal characters, from `list_groups` or an authorized retained reference. |
| `view` | no | string | `basic` (default) or `full`; Full adds up to 20 authorized match assessments per goal. |
| `pageSize` | no | integer | Default 20 (also for 0), capped at 100. Negative or fractional values are invalid. |
| `pageToken` | no | string | Omit or use an empty string to start. For continuation, pass the preceding `nextPageToken` unchanged. |

## Result

Each entry is the same authorized goal resource returned by [`list_goals`](/docs/mcp/tools/list_goals) and the goal portion of [`get_goal`](/docs/mcp/tools/get_goal): wording, owner, beneficiary, authorship, dates, audience, and owner-only private context, clarification and edit version. Goals are ordered newest saved first, then goal ID. Both the viewer and owner must still belong to the selected group. A selection hidden from this group is listed only to its owner, even if another group or conversation gives someone access to that goal.

Only owners receive private fields and edit versions; other viewers receive the same redacted fields as Get. Ownership does not establish authorship. Full adds a bounded match-assessment page as described in Get; Basic omits it. Search state and personal offers require separate reads. Missing or inaccessible groups return `unavailable`; an accessible group with no visible goals returns an empty list.

## Continuation

`nextPageToken` is always present. Only an empty string means the list is complete. Continue even if a page is short or empty when its token is nonempty. Tokens expire after one hour and are bound to this operation, authenticated member, and group where applicable. Keep all arguments other than `pageSize` unchanged. Invalid, expired, or mismatched tokens return `invalid_argument`; restart without a token. Each page rechecks current membership. These are live reads, not a snapshot across pages. Within a tool budget, report partial coverage truthfully rather than claiming completion.

## Example

```json list_group_goals
{
  "groupPublicId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "pageSize": 20
}
```

```json result:list_group_goals
{
  "goals": [
    {
      "id": "00000000-0000-4000-a000-000000000001",
      "text": "Find design partners",
      "beneficiary": null,
      "authorship": null,
      "owner": {
        "memberId": "00000000-0000-4000-a000-000000000003",
        "name": "Synthetic member"
      },
      "additionalContext": "Synthetic private details",
      "clarificationQuestion": null,
      "scopeVersion": 2,
      "version": "00000000-0000-4000-8000-000000000901",
      "suggestedByGravity": false,
      "retiredAt": null,
      "endReason": null,
      "createdAt": "2026-10-09T00:00:00.000Z",
      "isOwner": true,
      "audience": [
        {
          "groupPublicId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
          "name": "Synthetic founders",
          "visibility": "hidden"
        }
      ]
    }
  ],
  "nextPageToken": ""
}
```
