Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
---
title: ListNotifications
description: >-
List the current user's notifications.
---
# ListNotifications
List the current user's notifications. By default returns active notifications (not deleted, not done), ordered by most recent first. Use `states` to select exact unseen, seen, or done states. Seen excludes done; an empty list includes all states.
## Parameters
| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | integer | No | Maximum number of notifications to return. Defaults to 20, max 50. |
| `states` | (`"unseen"` \| `"seen"` \| `"done"`)[] | No | Exact states to include: unseen, seen, done. Defaults to [unseen, seen]. An empty list includes all states. |
| `includeTypes` | (`"email"` \| `"message"` \| `"channel"` \| `"document"` \| `"project"` \| `"call"` \| `"task"` \| `"github"` \| `"reminder"` \| `"calendar"` \| `"agent"`)[] | No | Filter to specific notification item types. If omitted, returns all types. Example: ["email", "message"] returns only email and message notifications. |
| `entities` | NotificationEntityFilter[] | No | Filter to notifications for specific entities. Pair each id with its canonical entityType to avoid ambiguity. Example: [\{"entityType":"email_thread","id":"..."}] returns notifications for one email thread. |