Docs: Tool reference
core toolset

list_notifications

List your notifications. Lists your notifications, newest first: new posts on boards you follow, comments and status changes on posts you own or take part in, mentions, assignments, merges and vote milestones. Each has a link. Use unread_only to see what's new, then mark_notifications_read. No side effects.

Toolset
core
Who can call it
OwnersManagersContributorsCustomers
REST
GET /api/v1/w/{workspace}/notifications
Behavior
read-onlyidempotent

Input

FieldTypeDescription
unread_onlyboolean Default: false.
cursorstringPass the previous response's next_cursor to get the next page.
limitintegerItems per page (default 25, max 100). Default: 25.

Output

FieldTypeDescription
itemsrequiredarray of object
unread_countrequiredinteger
next_cursorrequiredstring or nullCursor for the next page, or null when this is the last page.

Calling it

// MCP: tools/call
{ "name": "list_notifications", "arguments": {} }

// Typed client
await carechannel.list_notifications({});