@heznpc/imcp 0.1.0 → 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 heznpc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -1,41 +1,22 @@
 # iMcp
 
-Apple Notes용 MCP 서버. 완전한 CRUD, 일괄 스캔, 스마트 비교 — AI를 Apple 생태계에 연결합니다.
+Apple 생태계 전체를 위한 MCP 서버 — Notes, Reminders, Calendar, Contacts, Mail, Music, Finder, Safari, System, Photos, Shortcuts, Apple Intelligence. AI를 Mac에 연결합니다.
 
 > [English](README.md)
 
 ## 특징
 
-- **12개 도구** — 메모 목록/검색/읽기/생성/수정/삭제/이동 + 폴더 관리 + 일괄 작업
-- **3개 프롬프트** — 메모 정리, 중복 찾기, 주간 리뷰
-- **JXA 기반** — JavaScript for Automation으로 Apple Notes 직접 제어
+- **103개 도구** (12개 모듈) — Apple 앱 CRUD + 시스템 제어 + Apple Intelligence
+- **14개 프롬프트** — 앱별 워크플로우 + 크로스 모듈 (데일리 브리핑, 주간 다이제스트, 리서치, 집중 세션)
+- **4개 MCP 리소스** — Notes, Calendar, Reminders 실시간 데이터 URI
+- **JXA + Swift 브릿지** — JXA로 기본 자동화, EventKit/PhotoKit으로 고급 기능
+- **반복 이벤트/리마인더** — EventKit으로 반복 규칙 생성 (macOS 26+ Swift 브릿지)
+- **사진 가져오기/삭제** — PhotoKit으로 사진 관리 (macOS 26+ Swift 브릿지)
+- **Apple Intelligence** — 온디바이스 요약, 재작성, 교정 (macOS 26+)
+- **원클릭 셋업** — `setup_permissions` 도구로 모든 macOS 권한을 한번에 요청
 - **stdio 전송** — 안전한 로컬 통신, 네트워크 노출 없음
 - **Safety Annotations** — 모든 도구에 readOnly/destructive 힌트 적용
 
-## 유사 프로젝트 비교
-
-| | **iMcp** | **apple-mcp** | **iMCP** | **mcp-apple-notes** |
-|---|---|---|---|---|
-| 개발자 | heznpc | supermemoryai | loopwork-ai | RafalWilinski |
-| 상태 | **활성** | 아카이브 | 활성 | 저활성 |
-| 언어 | TypeScript | TypeScript | Swift | TypeScript |
-| 대상 앱 | Notes | Notes 등 7개 앱 | Calendar 등 10개 서비스 (Notes 미지원) | Notes |
-| Notes CRUD | **전체 (생성/읽기/수정/삭제/이동)** | 일부 | 없음 | 읽기 + 생성만 |
-| 도구 수 | 12 | 7 (앱당 1개 + enum) | 28 | 5 |
-| 일괄 작업 | scan / compare / bulk_move | 없음 | 없음 | 없음 |
-| 프롬프트 | 3개 (정리, 중복, 리뷰) | 없음 | 없음 | 없음 |
-| Safety Annotations | 전체 적용 | 없음 | 없음 | 없음 |
-| 전송 방식 | stdio | stdio | TCP/Bonjour | stdio |
-| 설치 | `npx @heznpc/imcp` | `bunx apple-mcp` | Homebrew cask / 앱 다운로드 | 수동 clone |
-| 검색 | 키워드 검색 | 키워드 검색 | — | 벡터 + 전문 검색 (RAG) |
-
-### 핵심 차이점
-
-- **apple-mcp** (3K+ 스타) — 가장 인기 있었으나 2026년 1월 아카이브. 더 이상 유지보수되지 않음
-- **iMCP** (loopwork-ai) — 네이티브 Swift 앱으로 가장 많은 서비스 지원. 그러나 **Notes를 지원하지 않고**, 대부분 읽기 전용이며, Bonjour로 네트워크 노출
-- **mcp-apple-notes** — RAG/시맨틱 검색이 독특한 장점이나, 도구가 5개뿐이고 CRUD가 불완전하며 npm 미배포
-- **iMcp** — Notes에 집중한 완전한 CRUD + 일괄 작업 + 가이드 프롬프트. `npx` 한 줄 실행, stdio로 보안 안전
-
 ## 빠른 시작
 
 ### Claude Desktop
@@ -68,63 +49,250 @@ npm install
 npm run build
 ```
 
-이후 MCP 클라이언트에서 `node dist/index.js`를 실행합니다.
-
 ## 도구
 
-### 메모
+### Notes (12개)
+
+| 도구 | 설명 | 타입 |
+|------|------|------|
+| `list_notes` | 메모 목록 (제목, 폴더, 날짜) | 읽기 |
+| `search_notes` | 키워드 검색 | 읽기 |
+| `read_note` | 전체 내용 조회 | 읽기 |
+| `create_note` | HTML 본문으로 생성 | 쓰기 |
+| `update_note` | 본문 전체 교체 | 파괴적 |
+| `delete_note` | 삭제 (최근 삭제로 이동) | 파괴적 |
+| `move_note` | 다른 폴더로 이동 | 파괴적 |
+| `list_folders` | 폴더 목록 | 읽기 |
+| `create_folder` | 폴더 생성 | 쓰기 |
+| `scan_notes` | 일괄 스캔 (미리보기 포함) | 읽기 |
+| `compare_notes` | 2~5개 메모 비교 | 읽기 |
+| `bulk_move_notes` | 여러 메모 일괄 이동 | 파괴적 |
+
+### Reminders (11개)
+
+| 도구 | 설명 | 타입 |
+|------|------|------|
+| `list_reminder_lists` | 리스트 목록 | 읽기 |
+| `list_reminders` | 리마인더 조회 (필터) | 읽기 |
+| `read_reminder` | 상세 조회 | 읽기 |
+| `create_reminder` | 생성 (마감일/우선순위) | 쓰기 |
+| `update_reminder` | 속성 변경 | 파괴적 |
+| `complete_reminder` | 완료/미완료 처리 | 쓰기 |
+| `delete_reminder` | 영구 삭제 | 파괴적 |
+| `search_reminders` | 이름/본문 키워드 검색 | 읽기 |
+| `create_reminder_list` | 새 리스트 생성 | 쓰기 |
+| `delete_reminder_list` | 리스트 삭제 | 파괴적 |
+| `create_recurring_reminder` | 반복 규칙으로 생성 (Swift/EventKit) | 쓰기 |
+
+### Calendar (10개)
+
+| 도구 | 설명 | 타입 |
+|------|------|------|
+| `list_calendars` | 캘린더 목록 | 읽기 |
+| `list_events` | 날짜 범위 이벤트 조회 | 읽기 |
+| `read_event` | 이벤트 상세 (참석자 포함) | 읽기 |
+| `create_event` | 이벤트 생성 | 쓰기 |
+| `update_event` | 이벤트 수정 | 파괴적 |
+| `delete_event` | 이벤트 삭제 | 파괴적 |
+| `search_events` | 키워드 검색 | 읽기 |
+| `get_upcoming_events` | 지금부터 다음 N개 이벤트 | 읽기 |
+| `today_events` | 오늘 일정 전체 | 읽기 |
+| `create_recurring_event` | 반복 규칙으로 이벤트 생성 (Swift/EventKit) | 쓰기 |
+
+### Contacts (10개)
+
+| 도구 | 설명 | 타입 |
+|------|------|------|
+| `list_contacts` | 연락처 목록 (페이지네이션) | 읽기 |
+| `search_contacts` | 이름/이메일/전화/조직 검색 | 읽기 |
+| `read_contact` | 상세 조회 (이메일, 전화, 주소) | 읽기 |
+| `create_contact` | 연락처 생성 | 쓰기 |
+| `update_contact` | 속성 변경 | 파괴적 |
+| `delete_contact` | 영구 삭제 | 파괴적 |
+| `list_groups` | 그룹 목록 | 읽기 |
+| `add_contact_email` | 기존 연락처에 이메일 추가 | 쓰기 |
+| `add_contact_phone` | 기존 연락처에 전화번호 추가 | 쓰기 |
+| `list_group_members` | 그룹 내 연락처 목록 | 읽기 |
+
+### Mail (9개)
 
 | 도구 | 설명 | 타입 |
 |------|------|------|
-| `list_notes` | 전체 메모 목록 (제목, 폴더, 날짜) | 읽기 |
-| `search_notes` | 키워드로 제목/본문 검색 | 읽기 |
-| `read_note` | 특정 메모의 전체 내용 조회 | 읽기 |
-| `create_note` | HTML 본문으로 새 메모 생성 | 쓰기 |
-| `update_note` | 메모 본문 전체 교체 | 파괴적 |
-| `delete_note` | 메모 삭제 (최근 삭제로 이동) | 파괴적 |
-| `move_note` | 메모를 다른 폴더로 이동 | 파괴적 |
+| `list_mailboxes` | 메일함 목록 (미읽음 수) | 읽기 |
+| `list_messages` | 메일함 내 메시지 목록 | 읽기 |
+| `read_message` | 메시지 전체 내용 | 읽기 |
+| `search_messages` | 제목/발신자 검색 | 읽기 |
+| `mark_message_read` | 읽음/안읽음 처리 | 쓰기 |
+| `flag_message` | 깃발 표시/해제 | 쓰기 |
+| `get_unread_count` | 전체 메일함 미읽음 수 | 읽기 |
+| `move_message` | 다른 메일함으로 이동 | 파괴적 |
+| `list_accounts` | 메일 계정 목록 | 읽기 |
+
+### Music (9개)
 
-### 폴더
+| 도구 | 설명 | 타입 |
+|------|------|------|
+| `list_playlists` | 재생목록 목록 | 읽기 |
+| `list_tracks` | 재생목록 내 트랙 | 읽기 |
+| `now_playing` | 현재 재생 중인 트랙 | 읽기 |
+| `playback_control` | 재생/일시정지/다음/이전 | 쓰기 |
+| `search_tracks` | 이름/아티스트/앨범 검색 | 읽기 |
+| `play_track` | 이름으로 특정 트랙 재생 | 쓰기 |
+| `play_playlist` | 재생목록 재생 시작 | 쓰기 |
+| `get_track_info` | 트랙 상세 메타데이터 | 읽기 |
+| `set_shuffle` | 셔플/반복 모드 설정 | 쓰기 |
+
+### Finder (8개)
 
 | 도구 | 설명 | 타입 |
 |------|------|------|
-| `list_folders` | 전체 폴더 목록 (메모 수 포함) | 읽기 |
+| `search_files` | Spotlight 파일 검색 | 읽기 |
+| `get_file_info` | 파일 정보 (크기, 날짜, 태그) | 읽기 |
+| `set_file_tags` | Finder 태그 설정 | 파괴적 |
+| `recent_files` | 최근 수정 파일 | 읽기 |
+| `list_directory` | 디렉토리 내 파일 목록 | 읽기 |
+| `move_file` | 파일 이동/이름 변경 | 파괴적 |
+| `trash_file` | 휴지통으로 이동 | 파괴적 |
 | `create_folder` | 새 폴더 생성 | 쓰기 |
 
-### 일괄 작업
+### Safari (8개)
 
 | 도구 | 설명 | 타입 |
 |------|------|------|
-| `scan_notes` | 메타데이터와 미리보기로 전체 메모 스캔 | 읽기 |
-| `compare_notes` | 2~5개 메모를 나란히 비교 | 읽기 |
-| `bulk_move_notes` | 여러 메모를 한 번에 이동 | 파괴적 |
+| `list_tabs` | 전체 윈도우의 탭 목록 | 읽기 |
+| `read_page_content` | 페이지 텍스트 내용 읽기 | 읽기 |
+| `get_current_tab` | 현재 활성 탭 URL/제목 | 읽기 |
+| `open_url` | Safari에서 URL 열기 | 쓰기 |
+| `close_tab` | 특정 탭 닫기 | 파괴적 |
+| `activate_tab` | 특정 탭으로 전환 | 쓰기 |
+| `run_javascript` | 탭에서 JavaScript 실행 | 쓰기 |
+| `search_tabs` | 제목/URL로 탭 검색 | 읽기 |
 
-## 프롬프트
+### System (9개)
 
-가이드 워크플로우로 메모를 정리할 수 있습니다:
+| 도구 | 설명 | 타입 |
+|------|------|------|
+| `get_clipboard` | 클립보드 내용 읽기 | 읽기 |
+| `set_clipboard` | 클립보드에 쓰기 | 쓰기 |
+| `get_volume` | 시스템 볼륨 확인 | 읽기 |
+| `set_volume` | 시스템 볼륨 설정 | 쓰기 |
+| `toggle_dark_mode` | 다크/라이트 모드 전환 | 쓰기 |
+| `get_frontmost_app` | 최전면 앱 확인 | 읽기 |
+| `list_running_apps` | 실행 중인 앱 목록 | 읽기 |
+| `get_screen_info` | 디스플레이 정보 | 읽기 |
+| `show_notification` | 시스템 알림 표시 | 쓰기 |
+
+### Photos (9개)
 
-- **organize-notes** — 전체 메모 스캔, 주제별 분류, 폴더 생성 및 이동
-- **find-duplicates** — 중복/유사 메모 찾기, 내용 비교, 정리 제안
-- **weekly-review** — 지난 1주일 메모 요약 및 정리 제안
+| 도구 | 설명 | 타입 |
+|------|------|------|
+| `list_albums` | 앨범 목록 | 읽기 |
+| `list_photos` | 앨범 내 사진 목록 | 읽기 |
+| `search_photos` | 키워드로 사진 검색 | 읽기 |
+| `get_photo_info` | 사진 상세 메타데이터 | 읽기 |
+| `list_favorites` | 즐겨찾기 사진 목록 | 읽기 |
+| `create_album` | 새 앨범 생성 | 쓰기 |
+| `add_to_album` | 앨범에 사진 추가 | 쓰기 |
+| `import_photo` | 파일에서 사진 가져오기 (Swift/PhotoKit) | 쓰기 |
+| `delete_photos` | ID로 사진 삭제 (Swift/PhotoKit) | 파괴적 |
+
+### Shortcuts (4개)
+
+| 도구 | 설명 | 타입 |
+|------|------|------|
+| `list_shortcuts` | 사용 가능한 단축어 목록 | 읽기 |
+| `run_shortcut` | 이름으로 단축어 실행 | 쓰기 |
+| `search_shortcuts` | 이름으로 단축어 검색 | 읽기 |
+| `get_shortcut_detail` | 단축어 상세 정보/액션 | 읽기 |
+
+### Apple Intelligence (3개)
+
+macOS 26+ Apple Silicon 필요.
+
+| 도구 | 설명 | 타입 |
+|------|------|------|
+| `summarize_text` | 온디바이스 텍스트 요약 | 읽기 |
+| `rewrite_text` | 톤 지정 재작성 | 읽기 |
+| `proofread_text` | 문법/맞춤법 교정 | 읽기 |
+
+## 리소스
+
+MCP 리소스는 Apple 앱의 실시간 데이터를 URI로 제공합니다.
+
+| URI | 설명 |
+|-----|------|
+| `notes://recent` | 최근 메모 10개 |
+| `notes://recent/{count}` | 최근 메모 (개수 지정) |
+| `calendar://today` | 오늘의 캘린더 이벤트 |
+| `reminders://due` | 기한 지난 리마인더 |
+
+## 프롬프트
+
+### 앱별
+- **organize-notes** — 메모 분류, 폴더 생성, 이동
+- **find-duplicates** — 중복 메모 찾기, 비교, 정리
+- **weekly-review** — 주간 메모 요약
+- **organize-reminders** — 리마인더 정리
+- **daily-review** — 오늘 마감 리마인더 리뷰
+- **schedule-review** — 향후 일정 리뷰, 충돌 확인
+- **meeting-prep** — 미팅 준비 (이벤트 + 관련 메모)
+
+### 크로스 모듈
+- **daily-briefing** — 오늘 일정 + 마감 리마인더 + 최근 메모 종합
+- **weekly-digest** — N일간 이벤트 + 메모 + 리마인더 종합 리뷰
+- **meeting-notes-to-reminders** — 미팅 메모에서 할 일 추출 → 리마인더 생성
+- **event-follow-up** — 미팅 후 팔로업 노트 + 리마인더 생성
+- **research-with-safari** — Safari로 조사 + Notes에 결과 저장
+- **focus-session** — Calendar + Reminders + Music으로 집중 세션
+- **file-organizer** — Finder로 파일 정리 + Notes에 기록
 
 ## 설정
 
 | 환경 변수 | 기본값 | 설명 |
 |----------|--------|------|
-| `IMCP_INCLUDE_SHARED` | `false` | 공유 메모/폴더를 결과에 포함 |
+| `IMCP_INCLUDE_SHARED` | `false` | 공유 메모/폴더 포함 |
 
 ## 요구 사항
 
-- macOS (Apple Notes는 macOS에서만 동작)
+- macOS
 - Node.js >= 18
-- 첫 실행 시 Notes.app 제어를 위한 자동화 권한 요청
+- 각 앱 자동화 권한 (첫 실행 시 요청) — `setup_permissions` 도구로 한번에 설정 가능
+- Apple Intelligence: macOS 26+ Apple Silicon
+
+## 제한 사항
+
+### Notes
+- 이동 시 복사 후 삭제 (새 ID, 날짜 초기화, 첨부 파일 유실)
+- 업데이트는 본문 전체를 교체합니다. 내용 보존을 위해 먼저 읽기
+- 비밀번호 보호된 메모 읽기 불가
+
+### Reminders / Calendar
+- JXA 반복 규칙은 읽기 전용 — `create_recurring_event`/`create_recurring_reminder` (Swift/EventKit) 사용
+- 캘린더 참석자 읽기 전용
+
+### Contacts
+- 사용자 지정 필드 접근 불가
+
+### Mail
+- 내용 기본 5000자 제한 (`maxLength` 파라미터로 조절 가능)
+
+### Music
+- 스마트 재생목록 읽기 전용
+- 대기열 조작 불가
+
+### Finder
+- 태그는 Spotlight (mdfind) 사용, 인덱스 상태에 따라 성능 변동
+
+### Safari
+- 페이지 내용 읽기에는 Safari 개발자 메뉴에서 Apple 이벤트의 JavaScript 허용 필요
 
-## 제약 사항
+### Photos
+- JXA: 앨범 생성 및 사진 추가 가능, 가져오기/삭제 불가
+- Swift 브릿지 (macOS 26+): PhotoKit으로 가져오기/삭제 가능
 
-- `move_note` / `bulk_move_notes`: Apple Notes에 네이티브 이동 명령이 없어 복사 후 삭제 방식. 새 ID 부여, 날짜 초기화, 첨부파일 손실.
-- `update_note`: 본문 전체를 교체. 부분 보존이 필요하면 먼저 read_note로 읽을 것. 첨부파일 손실 가능.
-- 검색은 클라이언트 사이드 (Apple Notes 스크립팅에 네이티브 검색 API 없음).
-- 비밀번호로 보호된 메모는 읽을 수 없음.
+### Apple Intelligence
+- macOS 26 (Tahoe) + Apple Silicon 필요
+- `npm run swift-build`로 브릿지 바이너리 빌드
 
 ## 라이선스
 

package/README.md

@@ -1,14 +1,19 @@
 # iMcp
 
-MCP server for Apple Notes. Full CRUD, bulk scan, and smart comparison — connect any AI to your Apple ecosystem.
+MCP server for the entire Apple ecosystem — Notes, Reminders, Calendar, Contacts, Mail, Music, Finder, Safari, System, Photos, Shortcuts, and Apple Intelligence. Connect any AI to your Mac.
 
 > [한국어](README.ko.md)
 
 ## Features
 
-- **12 tools** — list, search, read, create, update, delete, move notes + folder management + bulk operations
-- **3 prompts** — organize notes, find duplicates, weekly review
-- **JXA-based** — direct Apple Notes automation via JavaScript for Automation
+- **103 tools** across 12 modules — full CRUD for Apple apps + system control + Apple Intelligence
+- **14 prompts** — per-app workflows + cross-module (daily briefing, weekly digest, research, focus sessions)
+- **4 MCP Resources** — live data URIs for notes, calendar, and reminders
+- **JXA + Swift bridge** — JXA for core automation, EventKit/PhotoKit via Swift for advanced features
+- **Recurring events/reminders** — create recurrence rules via EventKit (macOS 26+ Swift bridge)
+- **Photos import/delete** — import and delete photos via PhotoKit (macOS 26+ Swift bridge)
+- **Apple Intelligence** — on-device summarization, rewriting, proofreading (macOS 26+)
+- **One-click setup** — `setup_permissions` tool triggers all macOS permission prompts at once
 - **stdio transport** — secure local communication, no network exposure
 - **Safety annotations** — every tool tagged with readOnly/destructive hints
 
@@ -44,44 +49,202 @@ npm install
 npm run build
 ```
 
-Then point your MCP client to `node dist/index.js`.
-
 ## Tools
 
-### Notes
+### Notes (12 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `list_notes` | List all notes with title, folder, dates | read |
+| `search_notes` | Search by keyword in title and body | read |
+| `read_note` | Read full content by ID | read |
+| `create_note` | Create a note with HTML body | write |
+| `update_note` | Replace entire body | destructive |
+| `delete_note` | Delete (moved to Recently Deleted) | destructive |
+| `move_note` | Move to another folder | destructive |
+| `list_folders` | List folders with note counts | read |
+| `create_folder` | Create a new folder | write |
+| `scan_notes` | Bulk scan with metadata and preview | read |
+| `compare_notes` | Compare 2-5 notes side by side | read |
+| `bulk_move_notes` | Move multiple notes at once | destructive |
+
+### Reminders (11 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `list_reminder_lists` | List all lists with counts | read |
+| `list_reminders` | Filter by list/completed | read |
+| `read_reminder` | Full details by ID | read |
+| `create_reminder` | Create with due date/priority | write |
+| `update_reminder` | Update properties | destructive |
+| `complete_reminder` | Mark complete/incomplete | write |
+| `delete_reminder` | Delete permanently | destructive |
+| `search_reminders` | Search by keyword in name/body | read |
+| `create_reminder_list` | Create a new reminder list | write |
+| `delete_reminder_list` | Delete a reminder list | destructive |
+| `create_recurring_reminder` | Create with recurrence rule (Swift/EventKit) | write |
+
+### Calendar (10 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `list_calendars` | List calendars with name/color | read |
+| `list_events` | Events in date range with pagination | read |
+| `read_event` | Full details with attendees | read |
+| `create_event` | Create with location/description | write |
+| `update_event` | Update properties | destructive |
+| `delete_event` | Delete permanently | destructive |
+| `search_events` | Keyword search in date range | read |
+| `get_upcoming_events` | Next N events from now | read |
+| `today_events` | All events for today | read |
+| `create_recurring_event` | Create with recurrence rule (Swift/EventKit) | write |
+
+### Contacts (10 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `list_contacts` | List with email/phone, pagination | read |
+| `search_contacts` | Search by name, email, phone, or org | read |
+| `read_contact` | Full details (emails, phones, addresses) | read |
+| `create_contact` | Create with email/phone/org | write |
+| `update_contact` | Update properties | destructive |
+| `delete_contact` | Delete permanently | destructive |
+| `list_groups` | List contact groups | read |
+| `add_contact_email` | Add email to existing contact | write |
+| `add_contact_phone` | Add phone to existing contact | write |
+| `list_group_members` | List contacts in a group | read |
+
+### Mail (9 tools)
 
 | Tool | Description | Type |
 |------|-------------|------|
-| `list_notes` | List all notes with title, folder, and dates | read |
-| `search_notes` | Search notes by keyword in title and body | read |
-| `read_note` | Read full content of a note by ID | read |
-| `create_note` | Create a new note with HTML body | write |
-| `update_note` | Replace entire body of a note | destructive |
-| `delete_note` | Delete a note (moved to Recently Deleted) | destructive |
-| `move_note` | Move a note to another folder | destructive |
+| `list_mailboxes` | List mailboxes with unread counts | read |
+| `list_messages` | Recent messages in a mailbox | read |
+| `read_message` | Full message content | read |
+| `search_messages` | Search by subject/sender | read |
+| `mark_message_read` | Mark read/unread | write |
+| `flag_message` | Flag/unflag a message | write |
+| `get_unread_count` | Total unread across all mailboxes | read |
+| `move_message` | Move message to another mailbox | destructive |
+| `list_accounts` | List all mail accounts | read |
 
-### Folders
+### Music (9 tools)
 
 | Tool | Description | Type |
 |------|-------------|------|
-| `list_folders` | List all folders with note counts | read |
+| `list_playlists` | List playlists with track counts | read |
+| `list_tracks` | Tracks in a playlist | read |
+| `now_playing` | Current track and playback state | read |
+| `playback_control` | Play, pause, next, previous | write |
+| `search_tracks` | Search by name/artist/album | read |
+| `play_track` | Play a specific track by name | write |
+| `play_playlist` | Start playing a playlist | write |
+| `get_track_info` | Detailed track metadata | read |
+| `set_shuffle` | Set shuffle and repeat mode | write |
+
+### Finder (8 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `search_files` | Spotlight search in a folder | read |
+| `get_file_info` | File size, dates, kind, tags | read |
+| `set_file_tags` | Set Finder tags on a file | destructive |
+| `recent_files` | Recently modified files | read |
+| `list_directory` | List files in a directory | read |
+| `move_file` | Move or rename a file | destructive |
+| `trash_file` | Move file to Trash | destructive |
 | `create_folder` | Create a new folder | write |
 
-### Bulk Operations
+### Safari (8 tools)
 
 | Tool | Description | Type |
 |------|-------------|------|
-| `scan_notes` | Bulk scan notes with metadata and preview | read |
-| `compare_notes` | Compare 2-5 notes side by side | read |
-| `bulk_move_notes` | Move multiple notes at once | destructive |
+| `list_tabs` | List all open tabs across windows | read |
+| `read_page_content` | Read text content of a page | read |
+| `get_current_tab` | Get the active tab URL and title | read |
+| `open_url` | Open a URL in Safari | write |
+| `close_tab` | Close a specific tab | destructive |
+| `activate_tab` | Switch to a specific tab | write |
+| `run_javascript` | Execute JavaScript in a tab | write |
+| `search_tabs` | Search tabs by title or URL | read |
+
+### System (9 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `get_clipboard` | Read clipboard contents | read |
+| `set_clipboard` | Write to clipboard | write |
+| `get_volume` | Get system volume level | read |
+| `set_volume` | Set system volume level | write |
+| `toggle_dark_mode` | Toggle dark/light mode | write |
+| `get_frontmost_app` | Get the frontmost application | read |
+| `list_running_apps` | List all running applications | read |
+| `get_screen_info` | Get display information | read |
+| `show_notification` | Display a system notification | write |
+
+### Photos (9 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `list_albums` | List photo albums | read |
+| `list_photos` | List photos in an album | read |
+| `search_photos` | Search photos by keyword | read |
+| `get_photo_info` | Detailed photo metadata | read |
+| `list_favorites` | List favorite photos | read |
+| `create_album` | Create a new album | write |
+| `add_to_album` | Add photos to an album | write |
+| `import_photo` | Import from file path (Swift/PhotoKit) | write |
+| `delete_photos` | Delete photos by ID (Swift/PhotoKit) | destructive |
+
+### Shortcuts (4 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `list_shortcuts` | List available Shortcuts | read |
+| `run_shortcut` | Run a Shortcut by name | write |
+| `search_shortcuts` | Search shortcuts by name | read |
+| `get_shortcut_detail` | Get shortcut details/actions | read |
+
+### Apple Intelligence (3 tools)
+
+Requires macOS 26+ with Apple Silicon. Graceful error on unsupported systems.
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `summarize_text` | On-device summarization | read |
+| `rewrite_text` | Rewrite in specified tone | read |
+| `proofread_text` | Grammar/spelling correction | read |
+
+## Resources
+
+MCP Resources expose live data from Apple apps as URIs.
+
+| URI | Description |
+|-----|-------------|
+| `notes://recent` | 10 most recent notes |
+| `notes://recent/{count}` | Recent notes (configurable count) |
+| `calendar://today` | Today's calendar events |
+| `reminders://due` | Overdue reminders |
 
 ## Prompts
 
-Use these guided workflows to organize your notes:
+### Per-App
+- **organize-notes** — Classify notes by topic, create folders, move
+- **find-duplicates** — Find similar notes, compare, suggest cleanup
+- **weekly-review** — Summarize past week's notes
+- **organize-reminders** — Scan, identify overdue/completed, cleanup
+- **daily-review** — Today's due reminders with priorities
+- **schedule-review** — Upcoming events, conflicts, optimizations
+- **meeting-prep** — Event details + related notes for meeting prep
 
-- **organize-notes** — Scan all notes, classify by topic, create folders, and move notes
-- **find-duplicates** — Find duplicate or similar notes, compare content, and suggest cleanup
-- **weekly-review** — Summarize notes from the past week and suggest actions
+### Cross-Module
+- **daily-briefing** — Today's events + due reminders + recent notes
+- **weekly-digest** — Past N days: events + notes + reminders combined
+- **meeting-notes-to-reminders** — Extract action items from meeting notes, create reminders
+- **event-follow-up** — Create follow-up note and reminders after a meeting
+- **research-with-safari** — Browse with Safari + save findings to Notes
+- **focus-session** — Calendar + Reminders + Music for focused work
+- **file-organizer** — Organize files with Finder + track in Notes
 
 ## Configuration
 
@@ -91,16 +254,45 @@ Use these guided workflows to organize your notes:
 
 ## Requirements
 
-- macOS (Apple Notes requires macOS)
+- macOS (Apple apps require macOS)
 - Node.js >= 18
-- First run will prompt for Automation permission to control Notes.app
+- First run will prompt for Automation permission for each app — use `setup_permissions` tool to grant all at once
+- Apple Intelligence tools require macOS 26+ with Apple Silicon
 
 ## Limitations
 
-- `move_note` / `bulk_move_notes`: Apple Notes has no native move command. Notes are copied and deleted, resulting in new IDs, reset dates, and lost attachments.
-- `update_note`: Replaces entire body. Read the note first to preserve content. Attachments may be lost.
-- Search is client-side (no native search API in Apple Notes scripting).
-- Password-protected notes cannot be read.
+### Notes
+- Move copies and deletes (new ID, reset dates, lost attachments)
+- Update replaces entire body. Read first to preserve content.
+- Password-protected notes unreadable.
+
+### Reminders / Calendar
+- JXA recurrence rules are read-only — use `create_recurring_event`/`create_recurring_reminder` (Swift/EventKit) to create recurring items
+- Calendar attendees are read-only
+
+### Contacts
+- Custom fields not accessible
+
+### Mail
+- Content truncated to 5000 characters by default (configurable via `maxLength` parameter)
+
+### Music
+- Smart playlists are read-only
+- No queue manipulation
+
+### Finder
+- Tags use Spotlight (mdfind), performance varies with index state
+
+### Safari
+- Reading page content requires Allow JavaScript from Apple Events in Safari Developer menu
+
+### Photos
+- JXA: albums can be created and photos added, but no import/delete
+- Swift bridge (macOS 26+): full import and delete via PhotoKit
+
+### Apple Intelligence
+- Requires macOS 26 (Tahoe) + Apple Silicon
+- Run `npm run swift-build` to compile the bridge binary
 
 ## License
 

package/dist/calendar/prompts.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCalendarPrompts(server: McpServer): void;