apple-notes

# Apple Notes Skill

Extract and monitor Apple Notes content for workflow integration with support for bulk extraction, real-time monitoring, and export to various formats.

## Prerequisites

- macOS with Apple Notes app
- Python 3.8+ (for coordination scripts)
- osascript (built-in macOS)
- Proper macOS permissions for Notes access

## Installation

```bash
# Run the installation script
./scripts/setup.sh

# Or manual setup
chmod +x scripts/*.py
pip3 install -r requirements.txt
```

## Commands

### Extract Notes

```bash
# Basic extraction (all notes)
python3 scripts/extract-notes.py --method simple

# Full extraction with attachments
python3 scripts/extract-notes.py --method full

# Extract specific folder
python3 scripts/extract-notes.py --folder "Work Notes"

# Output to specific format
python3 scripts/extract-notes.py --format markdown --output ~/notes
```

### Monitor Notes

```bash
# Start monitoring daemon
python3 scripts/monitor-notes.py --daemon

# Single check for changes
python3 scripts/monitor-notes.py --check-once

# Monitor with custom interval (seconds)
python3 scripts/monitor-notes.py --interval 30
```

### Processing and Export

```bash
# Process extracted notes
python3 scripts/notes-processor.py output/raw -o output/processed

# Export to Obsidian
python3 scripts/export-obsidian.py --vault ~/MyVault

# Generate knowledge graph
python3 scripts/knowledge-graph.py --input output/processed
```

## Configuration

Edit `configs/extractor.json` for:
- Output formats (JSON, Markdown, HTML)
- Privacy filters
- Folder selection
- Processing options

Edit `configs/monitor.json` for:
- Monitoring intervals
- Change detection settings
- Auto-processing rules

## Features

- ✅ Extract text content from all notes
- ✅ Handle embedded images and attachments  
- ✅ Process note metadata (dates, folders)
- ✅ Multiple output formats (JSON, Markdown, SQLite)
- ✅ Real-time monitoring for changes
- ✅ Privacy-first design with local processing
- ✅ Integration with...

# Apple Notes Automatic Extraction System

A comprehensive system for extracting and processing Apple Notes content for workflow integration.

## Overview

This system provides multiple extraction methods to handle different types of Apple Notes content:

1. **AppleScript/JXA Method** - Fast extraction for simple text notes
2. **Apple Cloud Notes Parser** - Complete extraction including attachments, tables, and embedded media
3. **Hybrid Approach** - Intelligent selection based on note complexity
4. **Real-time Monitoring** - Automated extraction of new/modified notes

## Features

- ✅ Extract text content from all notes
- ✅ Handle embedded images and attachments
- ✅ Process note metadata (creation date, modification date, folders)
- ✅ Support for different output formats (JSON, Markdown, SQLite)
- ✅ Integration with existing workflows
- ✅ Automatic deduplication and incremental updates
- ✅ Privacy-first design with local processing

## System Architecture

```
apple-notes-extractor/
├── scripts/           # Core extraction scripts
├── tools/            # External tools and dependencies
├── output/           # Extracted content storage
├── configs/          # Configuration files
└── workflows/        # Integration workflows
```

## Quick Start

1. **Initial Setup**: `./scripts/setup.sh`
2. **Basic Extraction**: `./scripts/extract-notes.py --method simple`
3. **Full Extraction**: `./scripts/extract-notes.py --method full`
4. **Monitor Mode**: `./scripts/monitor-notes.py --daemon`

## Security & Privacy

- All processing happens locally on your machine
- No data is sent to external services
- Respects macOS security permissions
- Optional encryption for sensitive notes

## Integration

The system integrates with:
- File-based workflows (Markdown, JSON output)
- Database systems (SQLite export)
- Search engines (full-text indexing)
- Note-taking apps (import/sync)
- AI processing pipelines

## Dependencies

- macOS with Apple Notes app
- Python 3.8+ (for coordin...