@heznpc/imcp 0.1.0

package/README.ko.md

@@ -0,0 +1,131 @@
+# iMcp
+
+Apple Notes용 MCP 서버. 완전한 CRUD, 일괄 스캔, 스마트 비교 — AI를 Apple 생태계에 연결합니다.
+
+> [English](README.md)
+
+## 특징
+
+- **12개 도구** — 메모 목록/검색/읽기/생성/수정/삭제/이동 + 폴더 관리 + 일괄 작업
+- **3개 프롬프트** — 메모 정리, 중복 찾기, 주간 리뷰
+- **JXA 기반** — JavaScript for Automation으로 Apple Notes 직접 제어
+- **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
+
+`~/Library/Application Support/Claude/claude_desktop_config.json`에 추가:
+
+```json
+{
+  "mcpServers": {
+    "imcp": {
+      "command": "npx",
+      "args": ["-y", "@heznpc/imcp"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add imcp -- npx -y @heznpc/imcp
+```
+
+### 로컬 개발
+
+```bash
+git clone https://github.com/heznpc/iMcp.git
+cd iMcp
+npm install
+npm run build
+```
+
+이후 MCP 클라이언트에서 `node dist/index.js`를 실행합니다.
+
+## 도구
+
+### 메모
+
+| 도구 | 설명 | 타입 |
+|------|------|------|
+| `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` | 여러 메모를 한 번에 이동 | 파괴적 |
+
+## 프롬프트
+
+가이드 워크플로우로 메모를 정리할 수 있습니다:
+
+- **organize-notes** — 전체 메모 스캔, 주제별 분류, 폴더 생성 및 이동
+- **find-duplicates** — 중복/유사 메모 찾기, 내용 비교, 정리 제안
+- **weekly-review** — 지난 1주일 메모 요약 및 정리 제안
+
+## 설정
+
+| 환경 변수 | 기본값 | 설명 |
+|----------|--------|------|
+| `IMCP_INCLUDE_SHARED` | `false` | 공유 메모/폴더를 결과에 포함 |
+
+## 요구 사항
+
+- macOS (Apple Notes는 macOS에서만 동작)
+- Node.js >= 18
+- 첫 실행 시 Notes.app 제어를 위한 자동화 권한 요청
+
+## 제약 사항
+
+- `move_note` / `bulk_move_notes`: Apple Notes에 네이티브 이동 명령이 없어 복사 후 삭제 방식. 새 ID 부여, 날짜 초기화, 첨부파일 손실.
+- `update_note`: 본문 전체를 교체. 부분 보존이 필요하면 먼저 read_note로 읽을 것. 첨부파일 손실 가능.
+- 검색은 클라이언트 사이드 (Apple Notes 스크립팅에 네이티브 검색 API 없음).
+- 비밀번호로 보호된 메모는 읽을 수 없음.
+
+## 라이선스
+
+MIT

package/README.md

@@ -0,0 +1,107 @@
+# iMcp
+
+MCP server for Apple Notes. Full CRUD, bulk scan, and smart comparison — connect any AI to your Apple ecosystem.
+
+> [한국어](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
+- **stdio transport** — secure local communication, no network exposure
+- **Safety annotations** — every tool tagged with readOnly/destructive hints
+
+## Quick Start
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "imcp": {
+      "command": "npx",
+      "args": ["-y", "@heznpc/imcp"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add imcp -- npx -y @heznpc/imcp
+```
+
+### Local Development
+
+```bash
+git clone https://github.com/heznpc/iMcp.git
+cd iMcp
+npm install
+npm run build
+```
+
+Then point your MCP client to `node dist/index.js`.
+
+## Tools
+
+### Notes
+
+| 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 |
+
+### Folders
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `list_folders` | List all folders with note counts | read |
+| `create_folder` | Create a new folder | write |
+
+### Bulk Operations
+
+| 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 |
+
+## Prompts
+
+Use these guided workflows to organize your notes:
+
+- **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
+
+## Configuration
+
+| Environment Variable | Default | Description |
+|---------------------|---------|-------------|
+| `IMCP_INCLUDE_SHARED` | `false` | Include shared notes/folders in results |
+
+## Requirements
+
+- macOS (Apple Notes requires macOS)
+- Node.js >= 18
+- First run will prompt for Automation permission to control Notes.app
+
+## 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.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerNoteTools } from "./notes/tools.js";
+import { registerNotePrompts } from "./notes/prompts.js";
+import { parseConfig } from "./shared/config.js";
+const config = parseConfig();
+const server = new McpServer({
+    name: "imcp",
+    version: "0.1.0",
+});
+registerNoteTools(server, config);
+registerNotePrompts(server);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`iMcp server running on stdio (shared notes: ${config.includeShared ? "on" : "off"})`);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;AAE7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAClC,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAE5B,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,+CAA+C,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;AACvG,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/notes/prompts.d.ts

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

package/dist/notes/prompts.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+function userPrompt(description, text) {
+    return {
+        description,
+        messages: [{ role: "user", content: { type: "text", text } }],
+    };
+}
+export function registerNotePrompts(server) {
+    server.prompt("organize-notes", { folder: z.string().optional().describe("Source folder to organize. Defaults to 'Notes'.") }, ({ folder }) => {
+        const target = folder ?? "Notes";
+        return userPrompt("Scan all notes, classify by topic, create folders, and move notes into them.", `Apple Notes의 "${target}" 폴더에 있는 메모를 정리해줘.
+
+다음 단계를 반드시 iMcp 도구를 사용해서 실행해:
+
+1. scan_notes(folder: "${target}")로 해당 폴더의 메모를 스캔해. 메모가 많으면 offset으로 페이징해서 전부 확인해
+2. 스캔 결과를 분석해서 주제별로 분류해
+3. 분류 결과를 나에게 보여주고 확인을 받아
+4. 확인 후 create_folder로 필요한 폴더를 생성해
+5. bulk_move_notes로 메모를 해당 폴더로 실제 이동시켜
+
+중요: MD 파일을 작성하지 말고, 실제 Apple Notes 앱에서 폴더를 만들고 메모를 이동해야 해.`);
+    });
+    server.prompt("find-duplicates", { folder: z.string().optional().describe("Folder to scan for duplicates. Defaults to all.") }, ({ folder }) => {
+        const scope = folder ? `"${folder}" 폴더의` : "전체";
+        return userPrompt("Find duplicate or similar notes, compare content, and suggest cleanup.", `Apple Notes에서 ${scope} 중복/유사 메모를 찾아서 정리해줘.
+
+다음 단계를 반드시 iMcp 도구를 사용해서 실행해:
+
+1. scan_notes로 메모를 스캔해 (folder 파라미터로 범위 지정 가능, offset으로 페이징)
+2. 제목이나 미리보기가 비슷한 메모 그룹을 찾아
+3. compare_notes로 유사 메모들의 전체 내용을 비교해
+4. 각 그룹별로 "어떤 걸 남기고 어떤 걸 삭제할지" 제안해
+5. 나의 확인 후 delete_note로 중복 메모를 삭제해
+
+중요: 삭제 전에 반드시 나에게 확인을 받아. 미리보기만 보고 판단하지 말고 compare_notes로 전체 내용을 확인해.`);
+    });
+    server.prompt("weekly-review", "Summarize notes from the past week and suggest organization actions.", () => {
+        const oneWeekAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString();
+        return userPrompt("Summarize notes from the past week and suggest organization actions.", `Apple Notes 주간 리뷰를 해줘.
+
+다음 단계를 반드시 iMcp 도구를 사용해서 실행해:
+
+1. scan_notes로 전체 메모를 스캔해 (메모가 많으면 offset으로 페이징)
+2. ${oneWeekAgo} 이후에 생성되거나 수정된 메모만 필터링해
+3. 이번 주 메모를 주제별로 요약해줘
+4. 정리가 필요한 메모가 있으면 제안해 (미분류, 빈 메모 등)
+5. 내가 원하면 폴더 이동이나 삭제를 실행해
+
+중요: 실제 iMcp 도구를 사용해서 Apple Notes 데이터를 조회해.`);
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/notes/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/notes/prompts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,SAAS,UAAU,CAAC,WAAmB,EAAE,IAAY;IACnD,OAAO;QACL,WAAW;QACX,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,EAAE,CAAC;KAChF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,MAAM,CACX,gBAAgB,EAChB,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC,EAAE,EAC7F,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;QACb,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAC;QACjC,OAAO,UAAU,CACf,8EAA8E,EAC9E,iBAAiB,MAAM;;;;yBAIN,MAAM;;;;;;2DAM4B,CACpD,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,iBAAiB,EACjB,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC,EAAE,EAC7F,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;QACb,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAChD,OAAO,UAAU,CACf,wEAAwE,EACxE,iBAAiB,KAAK;;;;;;;;;;sEAUwC,CAC/D,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,eAAe,EACf,sEAAsE,EACtE,GAAG,EAAE;QACH,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAChF,OAAO,UAAU,CACf,sEAAsE,EACtE;;;;;KAKH,UAAU;;;;;2CAK4B,CACpC,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/notes/scripts.d.ts

@@ -0,0 +1,15 @@
+export declare function listNotesScript(folder?: string): string;
+export declare function searchNotesScript(query: string, limit: number): string;
+export declare function readNoteScript(id: string): string;
+export declare function createNoteScript(body: string, folder?: string): string;
+export declare function createNoteSharedScript(body: string, folder?: string): string;
+export declare function guardSharedBulkScript(ids: string[]): string;
+export declare function guardSharedScript(id: string): string;
+export declare function updateNoteScript(id: string, body: string): string;
+export declare function deleteNoteScript(id: string): string;
+export declare function listFoldersScript(): string;
+export declare function createFolderScript(name: string, account?: string): string;
+export declare function scanNotesScript(limit: number, previewLength: number, offset: number, folder?: string): string;
+export declare function compareNotesScript(ids: string[]): string;
+export declare function moveNoteScript(id: string, targetFolder: string): string;
+export declare function bulkMoveNotesScript(ids: string[], targetFolder: string): string;

package/dist/notes/scripts.js

@@ -0,0 +1,348 @@
+// JXA scripts for Apple Notes automation.
+// Each function returns a JXA script string to be executed via osascript.
+export function listNotesScript(folder) {
+    if (folder) {
+        return `
+      const Notes = Application('Notes');
+      const folders = Notes.folders.whose({name: '${esc(folder)}'})();
+      if (folders.length === 0) throw new Error('Folder not found: ${esc(folder)}');
+      const f = folders[0];
+      const names = f.notes.name();
+      const ids = f.notes.id();
+      const creationDates = f.notes.creationDate();
+      const modificationDates = f.notes.modificationDate();
+      const shareds = f.notes.shared();
+      const result = names.map((name, i) => ({
+        id: ids[i],
+        name: name,
+        folder: '${esc(folder)}',
+        creationDate: creationDates[i].toISOString(),
+        modificationDate: modificationDates[i].toISOString(),
+        shared: shareds[i]
+      }));
+      JSON.stringify(result);
+    `;
+    }
+    return `
+    const Notes = Application('Notes');
+    const names = Notes.notes.name();
+    const ids = Notes.notes.id();
+    const creationDates = Notes.notes.creationDate();
+    const modificationDates = Notes.notes.modificationDate();
+    const containers = Notes.notes.container();
+    const shareds = Notes.notes.shared();
+    const result = names.map((name, i) => ({
+      id: ids[i],
+      name: name,
+      folder: containers[i].name(),
+      creationDate: creationDates[i].toISOString(),
+      modificationDate: modificationDates[i].toISOString(),
+      shared: shareds[i]
+    }));
+    JSON.stringify(result);
+  `;
+}
+export function searchNotesScript(query, limit) {
+    return `
+    const Notes = Application('Notes');
+    const names = Notes.notes.name();
+    const ids = Notes.notes.id();
+    const plaintexts = Notes.notes.plaintext();
+    const creationDates = Notes.notes.creationDate();
+    const modificationDates = Notes.notes.modificationDate();
+    const containers = Notes.notes.container();
+    const shareds = Notes.notes.shared();
+    const q = '${esc(query)}'.toLowerCase();
+    const result = [];
+    for (let i = 0; i < names.length && result.length < ${limit}; i++) {
+      if (names[i].toLowerCase().includes(q) || plaintexts[i].toLowerCase().includes(q)) {
+        result.push({
+          id: ids[i],
+          name: names[i],
+          folder: containers[i].name(),
+          creationDate: creationDates[i].toISOString(),
+          modificationDate: modificationDates[i].toISOString(),
+          preview: plaintexts[i].substring(0, 200),
+          shared: shareds[i]
+        });
+      }
+    }
+    JSON.stringify({total: names.length, returned: result.length, notes: result});
+  `;
+}
+export function readNoteScript(id) {
+    return `
+    const Notes = Application('Notes');
+    const note = Notes.notes.byId('${esc(id)}');
+    JSON.stringify({
+      id: note.id(),
+      name: note.name(),
+      body: note.body(),
+      plaintext: note.plaintext(),
+      creationDate: note.creationDate().toISOString(),
+      modificationDate: note.modificationDate().toISOString(),
+      folder: note.container().name(),
+      shared: note.shared(),
+      passwordProtected: note.passwordProtected()
+    });
+  `;
+}
+export function createNoteScript(body, folder) {
+    if (folder) {
+        return `
+      const Notes = Application('Notes');
+      const folders = Notes.folders.whose({name: '${esc(folder)}'})();
+      if (folders.length === 0) throw new Error('Folder not found: ${esc(folder)}');
+      if (folders[0].shared()) throw new Error('Cannot create notes in shared folder: ${esc(folder)}. Set IMCP_INCLUDE_SHARED=true to allow.');
+      const note = Notes.Note({body: '${esc(body)}'});
+      folders[0].notes.push(note);
+      JSON.stringify({id: note.id(), name: note.name()});
+    `;
+    }
+    return `
+    const Notes = Application('Notes');
+    const note = Notes.Note({body: '${esc(body)}'});
+    Notes.defaultAccount().defaultFolder().notes.push(note);
+    JSON.stringify({id: note.id(), name: note.name()});
+  `;
+}
+export function createNoteSharedScript(body, folder) {
+    if (folder) {
+        return `
+      const Notes = Application('Notes');
+      const folders = Notes.folders.whose({name: '${esc(folder)}'})();
+      if (folders.length === 0) throw new Error('Folder not found: ${esc(folder)}');
+      const note = Notes.Note({body: '${esc(body)}'});
+      folders[0].notes.push(note);
+      JSON.stringify({id: note.id(), name: note.name()});
+    `;
+    }
+    return `
+    const Notes = Application('Notes');
+    const note = Notes.Note({body: '${esc(body)}'});
+    Notes.defaultAccount().defaultFolder().notes.push(note);
+    JSON.stringify({id: note.id(), name: note.name()});
+  `;
+}
+export function guardSharedBulkScript(ids) {
+    const idsArray = ids.map((id) => `'${esc(id)}'`).join(",");
+    return `
+    const Notes = Application('Notes');
+    const ids = [${idsArray}];
+    const sharedIds = ids.filter(id => Notes.notes.byId(id).shared());
+    JSON.stringify({sharedIds: sharedIds});
+  `;
+}
+export function guardSharedScript(id) {
+    return `
+    const Notes = Application('Notes');
+    const note = Notes.notes.byId('${esc(id)}');
+    JSON.stringify({shared: note.shared()});
+  `;
+}
+export function updateNoteScript(id, body) {
+    return `
+    const Notes = Application('Notes');
+    const note = Notes.notes.byId('${esc(id)}');
+    note.body = '${esc(body)}';
+    JSON.stringify({id: note.id(), name: note.name()});
+  `;
+}
+export function deleteNoteScript(id) {
+    return `
+    const Notes = Application('Notes');
+    const note = Notes.notes.byId('${esc(id)}');
+    const name = note.name();
+    Notes.delete(note);
+    JSON.stringify({deleted: true, name: name});
+  `;
+}
+export function listFoldersScript() {
+    return `
+    const Notes = Application('Notes');
+    const accounts = Notes.accounts();
+    const result = [];
+    for (const acct of accounts) {
+      const aName = acct.name();
+      const fIds = acct.folders.id();
+      const fNames = acct.folders.name();
+      const fShared = acct.folders.shared();
+      for (let i = 0; i < fIds.length; i++) {
+        result.push({
+          id: fIds[i],
+          name: fNames[i],
+          account: aName,
+          noteCount: acct.folders[i].notes.length,
+          shared: fShared[i]
+        });
+      }
+    }
+    JSON.stringify(result);
+  `;
+}
+export function createFolderScript(name, account) {
+    if (account) {
+        return `
+      const Notes = Application('Notes');
+      const acct = Notes.accounts.whose({name: '${esc(account)}'})()[0];
+      if (!acct) throw new Error('Account not found: ${esc(account)}');
+      const existing = acct.folders.whose({name: '${esc(name)}'})();
+      if (existing.length > 0) JSON.stringify({id: existing[0].id(), name: existing[0].name(), existing: true});
+      else {
+        const folder = Notes.Folder({name: '${esc(name)}'});
+        acct.folders.push(folder);
+        JSON.stringify({id: folder.id(), name: folder.name(), existing: false});
+      }
+    `;
+    }
+    return `
+    const Notes = Application('Notes');
+    const acct = Notes.defaultAccount();
+    const existing = acct.folders.whose({name: '${esc(name)}'})();
+    if (existing.length > 0) JSON.stringify({id: existing[0].id(), name: existing[0].name(), existing: true});
+    else {
+      const folder = Notes.Folder({name: '${esc(name)}'});
+      acct.folders.push(folder);
+      JSON.stringify({id: folder.id(), name: folder.name(), existing: false});
+    }
+  `;
+}
+export function scanNotesScript(limit, previewLength, offset, folder) {
+    if (folder) {
+        return `
+      const Notes = Application('Notes');
+      const folders = Notes.folders.whose({name: '${esc(folder)}'})();
+      if (folders.length === 0) throw new Error('Folder not found: ${esc(folder)}');
+      const f = folders[0];
+      const names = f.notes.name();
+      const ids = f.notes.id();
+      const creationDates = f.notes.creationDate();
+      const modificationDates = f.notes.modificationDate();
+      const shareds = f.notes.shared();
+      const start = Math.min(${offset}, names.length);
+      const end = Math.min(start + ${limit}, names.length);
+      const result = [];
+      for (let i = start; i < end; i++) {
+        const pt = f.notes[i].plaintext();
+        result.push({
+          id: ids[i],
+          name: names[i],
+          folder: '${esc(folder)}',
+          creationDate: creationDates[i].toISOString(),
+          modificationDate: modificationDates[i].toISOString(),
+          preview: pt.substring(0, ${previewLength}),
+          charCount: pt.length,
+          shared: shareds[i]
+        });
+      }
+      JSON.stringify({total: names.length, offset: start, returned: result.length, notes: result});
+    `;
+    }
+    return `
+    const Notes = Application('Notes');
+    const names = Notes.notes.name();
+    const ids = Notes.notes.id();
+    const creationDates = Notes.notes.creationDate();
+    const modificationDates = Notes.notes.modificationDate();
+    const containers = Notes.notes.container();
+    const shareds = Notes.notes.shared();
+    const start = Math.min(${offset}, names.length);
+    const end = Math.min(start + ${limit}, names.length);
+    const result = [];
+    for (let i = start; i < end; i++) {
+      const pt = Notes.notes[i].plaintext();
+      result.push({
+        id: ids[i],
+        name: names[i],
+        folder: containers[i].name(),
+        creationDate: creationDates[i].toISOString(),
+        modificationDate: modificationDates[i].toISOString(),
+        preview: pt.substring(0, ${previewLength}),
+        charCount: pt.length,
+        shared: shareds[i]
+      });
+    }
+    JSON.stringify({total: names.length, offset: start, returned: result.length, notes: result});
+  `;
+}
+export function compareNotesScript(ids) {
+    const idsArray = ids.map((id) => `'${esc(id)}'`).join(",");
+    return `
+    const Notes = Application('Notes');
+    const targetIds = [${idsArray}];
+    const result = targetIds.map(id => {
+      const note = Notes.notes.byId(id);
+      const text = note.plaintext();
+      return {
+        id: note.id(),
+        name: note.name(),
+        plaintext: text,
+        folder: note.container().name(),
+        creationDate: note.creationDate().toISOString(),
+        modificationDate: note.modificationDate().toISOString(),
+        charCount: text.length,
+        shared: note.shared()
+      };
+    });
+    JSON.stringify(result);
+  `;
+}
+export function moveNoteScript(id, targetFolder) {
+    return `
+    const Notes = Application('Notes');
+    const note = Notes.notes.byId('${esc(id)}');
+    const folders = Notes.folders.whose({name: '${esc(targetFolder)}'})();
+    if (folders.length === 0) throw new Error('Folder not found: ${esc(targetFolder)}');
+    const body = note.body();
+    const originalName = note.name();
+    const newNote = Notes.Note({body: body});
+    folders[0].notes.push(newNote);
+    const newId = newNote.id();
+    if (!newId) throw new Error('Failed to create note in target folder');
+    Notes.delete(note);
+    JSON.stringify({
+      originalName: originalName,
+      newId: newId,
+      newName: newNote.name(),
+      targetFolder: '${esc(targetFolder)}'
+    });
+  `;
+}
+export function bulkMoveNotesScript(ids, targetFolder) {
+    const idsArray = ids.map((id) => `'${esc(id)}'`).join(",");
+    return `
+    const Notes = Application('Notes');
+    const folders = Notes.folders.whose({name: '${esc(targetFolder)}'})();
+    if (folders.length === 0) throw new Error('Folder not found: ${esc(targetFolder)}');
+    const targetIds = [${idsArray}];
+    const results = [];
+    for (const id of targetIds) {
+      try {
+        const note = Notes.notes.byId(id);
+        const body = note.body();
+        const originalName = note.name();
+        const newNote = Notes.Note({body: body});
+        folders[0].notes.push(newNote);
+        const newId = newNote.id();
+        if (!newId) throw new Error('Failed to create note copy');
+        Notes.delete(note);
+        results.push({success: true, originalName, newId: newId});
+      } catch(e) {
+        results.push({success: false, id: id, error: e.message});
+      }
+    }
+    JSON.stringify({targetFolder: '${esc(targetFolder)}', moved: results.filter(r => r.success).length, failed: results.filter(r => !r.success).length, results: results});
+  `;
+}
+function esc(str) {
+    return str
+        .replace(/\0/g, "")
+        .replace(/\\/g, "\\\\")
+        .replace(/'/g, "\\'")
+        .replace(/\n/g, "\\n")
+        .replace(/\r/g, "\\r")
+        .replace(/\t/g, "\\t")
+        .replace(/\u2028/g, "\\u2028")
+        .replace(/\u2029/g, "\\u2029");
+}
+//# sourceMappingURL=scripts.js.map

package/dist/notes/scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../../src/notes/scripts.ts"],"names":[],"mappings":"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"}

package/dist/notes/tools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ImcpConfig } from "../shared/config.js";
+export declare function registerNoteTools(server: McpServer, config: ImcpConfig): void;

package/dist/notes/tools.js

@@ -0,0 +1,325 @@
+import { z } from "zod";
+import { runJxa } from "../shared/jxa.js";
+import { listNotesScript, searchNotesScript, readNoteScript, createNoteScript, createNoteSharedScript, updateNoteScript, deleteNoteScript, guardSharedScript, guardSharedBulkScript, listFoldersScript, createFolderScript, scanNotesScript, compareNotesScript, moveNoteScript, bulkMoveNotesScript, } from "./scripts.js";
+function ok(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+function err(message) {
+    return {
+        content: [{ type: "text", text: message }],
+        isError: true,
+    };
+}
+function filterShared(items, includeShared) {
+    if (includeShared)
+        return items;
+    return items.filter((item) => !item.shared);
+}
+async function guardShared(id, includeShared) {
+    if (includeShared)
+        return null;
+    const result = await runJxa(guardSharedScript(id));
+    if (result.shared) {
+        return "This note is shared. Modifying shared notes is disabled by default. Set IMCP_INCLUDE_SHARED=true to allow.";
+    }
+    return null;
+}
+export function registerNoteTools(server, config) {
+    const { includeShared } = config;
+    // --- Layer 1: CRUD ---
+    server.registerTool("list_notes", {
+        title: "List Notes",
+        description: "List all notes with title, folder, and dates. Optionally filter by folder name.",
+        inputSchema: {
+            folder: z.string().optional().describe("Filter by folder name"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ folder }) => {
+        try {
+            const result = await runJxa(listNotesScript(folder));
+            return ok(filterShared(result, includeShared));
+        }
+        catch (e) {
+            return err(`Failed to list notes: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("search_notes", {
+        title: "Search Notes",
+        description: "Search notes by keyword in title and body. Returns matching notes with a 200-char preview.",
+        inputSchema: {
+            query: z.string().describe("Search keyword"),
+            limit: z.number().int().min(1).max(500).optional().default(50).describe("Max results to return (default: 50)"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ query, limit }) => {
+        try {
+            const result = await runJxa(searchNotesScript(query, limit));
+            result.notes = filterShared(result.notes, includeShared);
+            result.returned = result.notes.length;
+            return ok(result);
+        }
+        catch (e) {
+            return err(`Failed to search notes: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("read_note", {
+        title: "Read Note",
+        description: "Read the full content of a specific note by its ID. Returns HTML body and plaintext.",
+        inputSchema: {
+            id: z.string().describe("Note ID (x-coredata:// format)"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ id }) => {
+        try {
+            const result = await runJxa(readNoteScript(id));
+            if (!includeShared && result.shared)
+                return err("This note is shared. Set IMCP_INCLUDE_SHARED=true to access shared notes.");
+            return ok(result);
+        }
+        catch (e) {
+            return err(`Failed to read note: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("create_note", {
+        title: "Create Note",
+        description: "Create a new note with HTML body. The first line of the body becomes the note title automatically. Optionally specify a target folder.",
+        inputSchema: {
+            body: z.string().describe("Note content in HTML (e.g. '<h1>Title</h1><p>Body text</p>')"),
+            folder: z.string().optional().describe("Target folder name"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ body, folder }) => {
+        try {
+            const script = includeShared
+                ? createNoteSharedScript(body, folder)
+                : createNoteScript(body, folder);
+            const result = await runJxa(script);
+            return ok(result);
+        }
+        catch (e) {
+            return err(`Failed to create note: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("update_note", {
+        title: "Update Note",
+        description: "Replace the entire body of an existing note. WARNING: This overwrites all content. Read the note first if you need to preserve parts of it. Attachments may be lost.",
+        inputSchema: {
+            id: z.string().describe("Note ID (x-coredata:// format)"),
+            body: z.string().describe("New HTML body to replace existing content"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ id, body }) => {
+        try {
+            const blocked = await guardShared(id, includeShared);
+            if (blocked)
+                return err(blocked);
+            const result = await runJxa(updateNoteScript(id, body));
+            return ok(result);
+        }
+        catch (e) {
+            return err(`Failed to update note: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("delete_note", {
+        title: "Delete Note",
+        description: "Delete a note by ID. The note is moved to Recently Deleted and permanently removed after 30 days.",
+        inputSchema: {
+            id: z.string().describe("Note ID (x-coredata:// format)"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ id }) => {
+        try {
+            const blocked = await guardShared(id, includeShared);
+            if (blocked)
+                return err(blocked);
+            const result = await runJxa(deleteNoteScript(id));
+            return ok(result);
+        }
+        catch (e) {
+            return err(`Failed to delete note: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("list_folders", {
+        title: "List Folders",
+        description: "List all folders across all accounts with note counts.",
+        inputSchema: {},
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async () => {
+        try {
+            const result = await runJxa(listFoldersScript());
+            return ok(filterShared(result, includeShared));
+        }
+        catch (e) {
+            return err(`Failed to list folders: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("create_folder", {
+        title: "Create Folder",
+        description: "Create a new folder. Optionally specify which account to create it in.",
+        inputSchema: {
+            name: z.string().describe("Folder name"),
+            account: z.string().optional().describe("Account name (e.g. 'iCloud'). Defaults to primary account."),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ name, account }) => {
+        try {
+            const result = await runJxa(createFolderScript(name, account));
+            return ok(result);
+        }
+        catch (e) {
+            return err(`Failed to create folder: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("move_note", {
+        title: "Move Note",
+        description: "Move a note to a different folder. NOTE: Apple Notes has no native move command, so this copies the note body to the target folder and deletes the original. The note will get a new ID and creation date. Attachments (images) will be lost.",
+        inputSchema: {
+            id: z.string().describe("Note ID to move"),
+            folder: z.string().describe("Target folder name"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ id, folder }) => {
+        try {
+            const blocked = await guardShared(id, includeShared);
+            if (blocked)
+                return err(blocked);
+            const result = await runJxa(moveNoteScript(id, folder));
+            return ok(result);
+        }
+        catch (e) {
+            return err(`Failed to move note: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // --- Layer 2: Bulk ---
+    server.registerTool("scan_notes", {
+        title: "Scan Notes",
+        description: "Bulk scan notes returning metadata and a text preview for each. Supports pagination via offset. Optionally filter by folder. Use this to get an overview before organizing.",
+        inputSchema: {
+            folder: z.string().optional().describe("Filter by folder name. Omit to scan all notes."),
+            limit: z.number().int().min(1).max(10000).optional().default(100).describe("Max number of notes to return (default: 100)"),
+            offset: z.number().int().min(0).optional().default(0).describe("Number of notes to skip for pagination (default: 0)"),
+            previewLength: z.number().int().min(1).max(5000).optional().default(300).describe("Preview text length in characters (default: 300)"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ folder, limit, offset, previewLength }) => {
+        try {
+            const result = await runJxa(scanNotesScript(limit, previewLength, offset, folder));
+            result.notes = filterShared(result.notes, includeShared);
+            result.returned = result.notes.length;
+            return ok(result);
+        }
+        catch (e) {
+            return err(`Failed to scan notes: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("compare_notes", {
+        title: "Compare Notes",
+        description: "Retrieve full plaintext content of 2-5 notes at once for comparison. Use this after scan_notes to safely compare potentially duplicate or similar notes before deciding what to keep, merge, or delete.",
+        inputSchema: {
+            ids: z
+                .array(z.string())
+                .min(2)
+                .max(5)
+                .describe("Array of 2-5 note IDs to compare"),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ ids }) => {
+        try {
+            const result = await runJxa(compareNotesScript(ids));
+            if (!includeShared) {
+                const shared = result.filter((n) => n.shared);
+                if (shared.length > 0)
+                    return err(`Shared notes found: ${shared.map((n) => n.name).join(", ")}. Set IMCP_INCLUDE_SHARED=true to access.`);
+            }
+            return ok(result);
+        }
+        catch (e) {
+            return err(`Failed to compare notes: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("bulk_move_notes", {
+        title: "Bulk Move Notes",
+        description: "Move multiple notes to a target folder at once. Same limitations as move_note apply to each note (new ID, date reset, attachments lost). Returns per-note success/failure results.",
+        inputSchema: {
+            ids: z.array(z.string()).min(1).describe("Array of note IDs to move"),
+            folder: z.string().describe("Target folder name"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async ({ ids, folder }) => {
+        try {
+            if (!includeShared) {
+                const { sharedIds } = await runJxa(guardSharedBulkScript(ids));
+                if (sharedIds.length > 0)
+                    return err(`Blocked: ${sharedIds.length} shared note(s) found. Set IMCP_INCLUDE_SHARED=true to allow.`);
+            }
+            const result = await runJxa(bulkMoveNotesScript(ids, folder));
+            return ok(result);
+        }
+        catch (e) {
+            return err(`Failed to bulk move notes: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/notes/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/notes/tools.ts"],"names":[],"mappings":"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"}

package/dist/shared/config.d.ts

@@ -0,0 +1,5 @@
+export interface ImcpConfig {
+    /** Include shared notes/folders in results. Default: false */
+    includeShared: boolean;
+}
+export declare function parseConfig(): ImcpConfig;

package/dist/shared/config.js

@@ -0,0 +1,6 @@
+export function parseConfig() {
+    return {
+        includeShared: process.env.IMCP_INCLUDE_SHARED === "true",
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/shared/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,MAAM;KAC1D,CAAC;AACJ,CAAC"}

package/dist/shared/jxa.d.ts

@@ -0,0 +1 @@
+export declare function runJxa<T>(script: string): Promise<T>;

package/dist/shared/jxa.js

@@ -0,0 +1,29 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const TIMEOUT_MS = 30_000;
+const MAX_BUFFER = 10 * 1024 * 1024; // 10 MB
+export async function runJxa(script) {
+    let stdout;
+    try {
+        const result = await execFileAsync("osascript", ["-l", "JavaScript", "-e", script], { timeout: TIMEOUT_MS, maxBuffer: MAX_BUFFER });
+        stdout = result.stdout;
+    }
+    catch (e) {
+        const err = e;
+        if (err.killed || err.signal === "SIGTERM") {
+            throw new Error(`osascript timed out after ${TIMEOUT_MS / 1000}s`);
+        }
+        throw e;
+    }
+    const trimmed = stdout.trim();
+    if (!trimmed)
+        throw new Error("osascript returned empty output");
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        throw new Error(`osascript returned invalid JSON: ${trimmed.slice(0, 200)}`);
+    }
+}
+//# sourceMappingURL=jxa.js.map

package/dist/shared/jxa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jxa.js","sourceRoot":"","sources":["../../src/shared/jxa.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,UAAU,GAAG,MAAM,CAAC;AAC1B,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ;AAE7C,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,MAAc;IAC5C,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAChC,WAAW,EACX,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,EAClC,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,CAC/C,CAAC;QACF,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACzB,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAA2D,CAAC;QACxE,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACjE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@heznpc/imcp",
+  "version": "0.1.0",
+  "description": "MCP server for Apple Notes — full CRUD, bulk scan, and smart comparison. Connect any AI to your Apple ecosystem.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "apple",
+    "notes",
+    "apple-notes",
+    "claude",
+    "llm",
+    "ai",
+    "applescript",
+    "macos"
+  ],
+  "homepage": "https://github.com/heznpc/iMcp",
+  "bugs": {
+    "url": "https://github.com/heznpc/iMcp/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/heznpc/iMcp.git"
+  },
+  "license": "MIT",
+  "author": "heznpc",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "imcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run clean && npm run build",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "os": [
+    "darwin"
+  ]
+}