Inbox
Per-person notifications.
On this page
Updated on January 1, 1970
Privacy and analytics
We use necessary technical cookies and, only with your consent, analytics and marketing pixels to improve the website and measure campaigns.
Privacy and analytics
We use necessary technical cookies and, only with your consent, analytics and marketing pixels to improve the website and measure campaigns.
Per-person notifications.
Updated on January 1, 1970
The caller's Inbox in this brand only: priority (named, given something, asked to approve, or high stakes), other, later, saved or done; newest first. Each item says its lane and why it arrived.
| Field | Value |
|---|---|
| Kind | Read |
| HTTP method | POST /api/v1/inbox.notifications.list |
| MCP tool | inbox_notifications_list |
| Scope | inbox.read |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Nödo, Voice, API, Chat, Screens, Apps |
| Status | Available |
| Widget | list |
Input
{
view?: "priority" | "other" | "later" | "saved" | "done" // default "priority"
unreadOnly?: boolean // default false
cursor?: string // ≤ 512 · Opaque cursor from a previous `nextCursor`.
limit?: integer // 1–50 · default 20
}Output
{
items: Array<{
id: string // uuid
title: string
body: string | null
link: string | null
lane: "priority" | "other"
reason: string | null
read: boolean
saved: boolean
createdAt: string
}>
nextCursor: string | null
}Marks the caller notifications as read; without ids, all of them in this brand.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/inbox.notifications.mark_read |
| MCP tool | inbox_notifications_mark_read |
| Scope | inbox.write |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Nödo, API, Chat, Screens, Apps |
| Status | Available |
Input
{
ids?: string[] // ≤ 100 items
}Output
{
ok: true
id?: string
revision?: integer // -9007199254740991–9007199254740991
}On the caller's notices in this brand: done (leaves the Inbox, stays under Done, can come back), saved, or snoozedUntil a future moment (null wakes them). Send only what changes; ids outside the brand are ignored.
| Field | Value |
|---|---|
| Kind | Write |
| HTTP method | POST /api/v1/inbox.notifications.update |
| MCP tool | inbox_notifications_update |
| Scope | inbox.write |
| Minimum role | Viewer |
| Human confirmation | No |
| Doors | Nödo, API, Chat, Screens, Apps |
| Status | Available |
Input
{
ids: string[] // ≤ 100 items
done?: boolean
saved?: boolean
snoozedUntil?: string | null
}Output
{
ok: true
id?: string
revision?: integer // -9007199254740991–9007199254740991
}