Browse the docs

Read recent notifications

Reads the notifications the Mac delivered lately, newest first, so a macro can summarise what you missed.

Read the app notifications from the last within

Details #

Reads from the same place as the App notification trigger, the Notification Center database, so it needs Full Disk Access for Switchboard Engine. The trigger never replays history; this step is how a macro gets at it: "when my Focus ends, tell me what came in".

app limits it to one app's bundle id. within says how far back: 30m, 2h, 1d, a number of seconds, or nothing for as far as the database goes. limit is how many at most (default 50, at most 500).

The step's output is { "notifications": [...], "count": n }. Each notification has app, appName, title, subtitle, body, at (an ISO date), silenced and link. into receives the list itself.

Parameters #

ParameterTypeRequiredValuesWhat it does
apptextBundle id of one app. Every app when left out.
intotextThe variable that receives the list.
limitnumberThe most notifications to return, newest first. Default 50.
sampleany valueWhat into holds during a dry run.
withinany valueHow far back to look, such as 30m, 2h or 1d.

Every step also accepts label, onFailure, timeout and dryRunSafe.

Examples #

Read what Slack said in the last hour
Do
  1. Read the Slack notifications from the last “1h”
  2. Show “{{ length(missed) }} from Slack”
Open in Switchboard to try it

Gotchas #

  • Without Full Disk Access the step fails and says to allow it. Banners are not stored anywhere, so there is no fallback.

  • Notifications from Switchboard itself are left out.

  • Only what macOS kept: it trims old notifications, so a long within may return fewer than you expect.

See also #

App notification, Show notification