macOS Notification Reader

Reads the macOS notification center database and exports recent notifications to markdown files. Also supports automated work notification summary with filtering and delivery.

Features

• 📱 Multi-app support: WeChat, Teams, Outlook, Mail, iMessage, Calendar, Reminders, and more
• ⏰ Time filtering: Fetch notifications from the last N minutes or hours
• 📅 Date-organized output: Exports to memory/YYYY-MM-DD/computer_io/notification/
• 🤖 Cron scheduling: Designed for automated periodic exports
• 📊 Work notification summary: Auto-filter work-related notifications (Teams/Outlook) and generate summaries
• 🔒 Privacy-friendly: Reads from local database only, no cloud upload

Quick Start

1. Grant Full Disk Access (Required)

This skill requires Full Disk Access to read the macOS notification database.

# Verify permission
python3 -c "import os; print('OK' if os.access(os.path.expanduser('~/Library/Group Containers/group.com.apple.usernoted/db2/db'), os.R_OK) else 'FAIL')"

If it returns FAIL, follow these steps:

1. Open System Settings → Privacy & Security → Full Disk Access
2. Click the 🔒 lock and enter your password
3. Click +, press Cmd+Shift+G, enter /usr/bin/python3, click Open
4. Ensure the toggle is ON

Note: If using a virtual environment, add the Python binary from that venv instead.

2. Test the Scripts

# Navigate to the skill directory
cd /path/to/macos-notification-reader

# Basic: Read notifications from the last 35 minutes
python3 scripts/read_notifications.py --minutes 35

# Basic: Read notifications from the last 24 hours
python3 scripts/read_notifications.py --hours 24

# Advanced: Generate work notification summary (every 30 min)
bash scripts/work-summary.sh

3. Set Up Cron Jobs (Recommended)

Option A: Basic Notification Export (every 30 min)

# Edit crontab
crontab -e

# Add this line:
*/30 * * * * /path/to/macos-notification-reader/scripts/export-notification.sh

Option B: Work Notification Summary (every 30 min)

This filters work-related notifications (Teams, Outlook) and generates a summary:

crontab -e

# Add this line:
*/30 * * * * /path/to/macos-notification-reader/scripts/work-summary.sh

Or use OpenClaw's built-in cron:

openclaw cron add --name "Work Notification Summary" --every "30m" --message "Run work-summary.sh"

Scripts

Work Notification Summary

The work-summary.sh script does: