list_notifications
List the inbox (unread / all / snoozed / archived), keyset paginated — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:read permission).
List the inbox (unread / all / snoozed / archived), keyset paginated.
| Required permission | work:read |
| Capability ID | notifications.list |
| Destructive | No |
Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
state | unread | all | snoozed | archived | no | |
cursor | string | no | |
limit | integer | no |
Input schema (JSON Schema)
{
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"unread",
"all",
"snoozed",
"archived"
],
"default": "unread"
},
"cursor": {
"type": "string"
},
"limit": {
"type": "integer",
"minimum": 0,
"maximum": 200,
"default": 50
}
},
"additionalProperties": false
}Access control
A call succeeds only when the personal access token's scopes and the holder's role both allow work:read (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.
list_members
List members of the organization and their roles — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the members:read permission).
list_projects
List accessible projects in the workspace (keyset paginated) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:read permission).