# `list_groups`

Lists the groups you belong to.

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

## When to use it

- To turn a group's name into its `publicId`. If a name matches more than one group, ask which one is meant.
- To show which groups a goal could be shared with.

It doesn't list anyone's contacts.

## Inputs

No inputs.

## Returns

`{ "myGroups": [...] }`, sorted by name. Each group has:

| Field | Type | Description |
| --- | --- | --- |
| `publicId` | string | The group's ID for other tools |
| `name` | string | Group name |
| `description` | string or null | Group description |
| `memberCount` | number | Current members |
| `hasActiveGoal` | boolean | You have an active goal shared with this group |
| `isModerator` | boolean | You moderate this group |

## Example

```json list_groups
{}
```

Result:

```json
{
  "myGroups": [
    {
      "publicId": "3a9f0c6e1b2d4e5f8a7b6c5d4e3f2a1b",
      "name": "Founders dinner",
      "description": "Operators who meet monthly.",
      "memberCount": 7,
      "hasActiveGoal": true,
      "isModerator": false
    }
  ]
}
```

## Related

- [`get_group_details`](/docs/mcp/tools/get_group_details) reads one group's roster and shared goals.
- [Goals and audiences](/docs/mcp/concepts/goals) explains how groups decide who reads a goal.