Macos Notification Reader

# 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.

```bash
# 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

```bash
# 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)

```bash
# Edit crontab
crontab -e

# Add this line:
*/30 * * * *...