@heznpc/imcp 0.8.0 → 0.9.0

package/README.ko.md

@@ -1,12 +1,12 @@
 # iMcp
 
-Apple 생태계 전체를 위한 MCP 서버 — Notes, Reminders, Calendar, Contacts, Mail, Music, Finder, Safari, System, Photos, Shortcuts, Apple Intelligence. AI를 Mac에 연결합니다.
+Apple 생태계 전체를 위한 MCP 서버 — Notes, Reminders, Calendar, Contacts, Mail, Messages, Music, Finder, Safari, System, Photos, Shortcuts, Apple Intelligence. AI를 Mac에 연결합니다.
 
 > [English](README.md)
 
 ## 특징
 
-- **104개 도구** (12개 모듈) — Apple 앱 CRUD + 시스템 제어 + Apple Intelligence
+- **110개 도구** (13개 모듈) — Apple 앱 CRUD + 시스템 제어 + Apple Intelligence
 - **20개 프롬프트** — 앱별 워크플로우 + 크로스 모듈 + 개발자 워크플로우 (dev-session, debug-loop, build-log)
 - **4개 MCP 리소스** — Notes, Calendar, Reminders 실시간 데이터 URI
 - **JXA + Swift 브릿지** — JXA로 기본 자동화, EventKit/PhotoKit으로 고급 기능
@@ -209,6 +209,17 @@ cd app && swift build -c release
 | `import_photo` | 파일에서 사진 가져오기 (Swift/PhotoKit) | 쓰기 |
 | `delete_photos` | ID로 사진 삭제 (Swift/PhotoKit) | 파괴적 |
 
+### Messages (6개)
+
+| 도구 | 설명 | 타입 |
+|------|------|------|
+| `list_chats` | 최근 대화 목록 (참여자 포함) | 읽기 |
+| `read_chat` | 대화 상세 조회 (참여자, 마지막 업데이트 포함) | 읽기 |
+| `search_chats` | 이름/참여자/핸들로 검색 | 읽기 |
+| `send_message` | iMessage/SMS 텍스트 전송 | 쓰기 |
+| `send_file` | iMessage/SMS 파일 첨부 전송 | 쓰기 |
+| `list_participants` | 대화 참여자 목록 | 읽기 |
+
 ### Shortcuts (4개)
 
 | 도구 | 설명 | 타입 |
@@ -331,6 +342,10 @@ AI 코딩 에이전트(Claude Code, Cursor, Copilot)가 MCP 프롬프트로 호
 ### Mail
 - 내용 기본 5000자 제한 (`maxLength` 파라미터로 조절 가능)
 
+### Messages
+- 개별 메시지 내용(대화 기록)은 JXA로 접근 불가
+- 전송 시 수신자가 Messages 서비스에 등록된 buddy여야 함
+
 ### Music
 - 스마트 재생목록 읽기 전용
 - 대기열 조작 불가

package/README.md

@@ -1,12 +1,12 @@
 # iMcp
 
-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.
+MCP server for the entire Apple ecosystem — Notes, Reminders, Calendar, Contacts, Mail, Messages, Music, Finder, Safari, System, Photos, Shortcuts, and Apple Intelligence. Connect any AI to your Mac.
 
 > [한국어](README.ko.md)
 
 ## Features
 
-- **104 tools** across 12 modules — full CRUD for Apple apps + system control + Apple Intelligence
+- **110 tools** across 13 modules — full CRUD for Apple apps + system control + Apple Intelligence
 - **20 prompts** — per-app workflows + cross-module + developer workflows (dev-session, debug-loop, build-log)
 - **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
@@ -209,6 +209,17 @@ Features: server status indicator, one-click permission setup, copy Claude confi
 | `import_photo` | Import from file path (Swift/PhotoKit) | write |
 | `delete_photos` | Delete photos by ID (Swift/PhotoKit) | destructive |
 
+### Messages (6 tools)
+
+| Tool | Description | Type |
+|------|-------------|------|
+| `list_chats` | List recent chats with participants | read |
+| `read_chat` | Read chat details including participants and last update | read |
+| `search_chats` | Search by name, participant, or handle | read |
+| `send_message` | Send text via iMessage/SMS | write |
+| `send_file` | Send file attachment via iMessage/SMS | write |
+| `list_participants` | List participants in a chat | read |
+
 ### Shortcuts (4 tools)
 
 | Tool | Description | Type |
@@ -331,6 +342,10 @@ These prompts are designed for AI coding agents (Claude Code, Cursor, Copilot) t
 ### Mail
 - Content truncated to 5000 characters by default (configurable via `maxLength` parameter)
 
+### Messages
+- Chat message history (individual message content) is not accessible via JXA
+- Send requires the recipient to be a known buddy in the Messages service
+
 ### Music
 - Smart playlists are read-only
 - No queue manipulation

package/dist/index.js

@@ -15,6 +15,7 @@ import { registerSafariTools } from "./safari/tools.js";
 import { registerSystemTools } from "./system/tools.js";
 import { registerPhotosTools } from "./photos/tools.js";
 import { registerShortcutsTools } from "./shortcuts/tools.js";
+import { registerMessagesTools } from "./messages/tools.js";
 import { registerIntelligenceTools } from "./intelligence/tools.js";
 import { registerCrossPrompts } from "./cross/prompts.js";
 import { registerResources } from "./shared/resources.js";
@@ -23,7 +24,7 @@ import { parseConfig } from "./shared/config.js";
 const config = parseConfig();
 const server = new McpServer({
     name: "imcp",
-    version: "0.8.0",
+    version: "0.9.0",
 });
 // Apple Apps
 registerNoteTools(server, config);
@@ -40,6 +41,7 @@ registerSafariTools(server, config);
 registerSystemTools(server, config);
 registerPhotosTools(server, config);
 registerShortcutsTools(server, config);
+registerMessagesTools(server, config);
 // Apple Intelligence
 registerIntelligenceTools(server, config);
 // Cross-module workflows

package/dist/index.js.map

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

package/dist/messages/scripts.d.ts

@@ -0,0 +1,6 @@
+export declare function listChatsScript(limit: number): string;
+export declare function readChatScript(chatId: string): string;
+export declare function searchMessagesScript(query: string, limit: number): string;
+export declare function sendMessageScript(target: string, text: string): string;
+export declare function sendFileScript(target: string, filePath: string): string;
+export declare function listParticipantsScript(chatId: string): string;

package/dist/messages/scripts.js

@@ -0,0 +1,103 @@
+// JXA scripts for Apple Messages automation.
+import { esc } from "../shared/esc.js";
+export function listChatsScript(limit) {
+    return `
+    const Messages = Application('Messages');
+    const chats = Messages.chats();
+    const count = Math.min(chats.length, ${limit});
+    const result = [];
+    for (let i = 0; i < count; i++) {
+      const c = chats[i];
+      const participants = c.participants();
+      result.push({
+        id: c.id(),
+        name: c.name() || null,
+        participants: participants.map(p => ({
+          name: p.name(),
+          handle: p.handle()
+        })),
+        updated: c.updatedDate() ? c.updatedDate().toISOString() : null
+      });
+    }
+    JSON.stringify({total: chats.length, returned: count, chats: result});
+  `;
+}
+export function readChatScript(chatId) {
+    return `
+    const Messages = Application('Messages');
+    const chats = Messages.chats.whose({id: '${esc(chatId)}'})();
+    if (chats.length === 0) throw new Error('Chat not found: ${esc(chatId)}');
+    const chat = chats[0];
+    const participants = chat.participants();
+    JSON.stringify({
+      id: chat.id(),
+      name: chat.name() || null,
+      participants: participants.map(p => ({name: p.name(), handle: p.handle()})),
+      updated: chat.updatedDate() ? chat.updatedDate().toISOString() : null
+    });
+  `;
+}
+export function searchMessagesScript(query, limit) {
+    return `
+    const Messages = Application('Messages');
+    const chats = Messages.chats();
+    const q = '${esc(query)}'.toLowerCase();
+    const result = [];
+    for (const chat of chats) {
+      if (result.length >= ${limit}) break;
+      const name = chat.name() || '';
+      const participants = chat.participants();
+      const participantNames = participants.map(p => p.name() || '').join(' ');
+      const participantHandles = participants.map(p => p.handle() || '').join(' ');
+      if (name.toLowerCase().includes(q) ||
+          participantNames.toLowerCase().includes(q) ||
+          participantHandles.toLowerCase().includes(q)) {
+        result.push({
+          id: chat.id(),
+          name: name || null,
+          participants: participants.map(p => ({name: p.name(), handle: p.handle()})),
+          updated: chat.updatedDate() ? chat.updatedDate().toISOString() : null
+        });
+      }
+    }
+    JSON.stringify({returned: result.length, chats: result});
+  `;
+}
+export function sendMessageScript(target, text) {
+    return `
+    const Messages = Application('Messages');
+    const service = Messages.services().find(s => s.serviceType() === 'iMessage') || Messages.services()[0];
+    if (!service) throw new Error('No messaging service available');
+    const buddy = service.buddies.whose({handle: '${esc(target)}'})();
+    if (buddy.length === 0) throw new Error('Buddy not found for handle: ${esc(target)}');
+    Messages.send('${esc(text)}', {to: buddy[0]});
+    JSON.stringify({sent: true, to: '${esc(target)}', text: '${esc(text)}'.substring(0, 100)});
+  `;
+}
+export function sendFileScript(target, filePath) {
+    return `
+    const Messages = Application('Messages');
+    const service = Messages.services().find(s => s.serviceType() === 'iMessage') || Messages.services()[0];
+    if (!service) throw new Error('No messaging service available');
+    const buddy = service.buddies.whose({handle: '${esc(target)}'})();
+    if (buddy.length === 0) throw new Error('Buddy not found for handle: ${esc(target)}');
+    const file = Path('${esc(filePath)}');
+    Messages.send(file, {to: buddy[0]});
+    JSON.stringify({sent: true, to: '${esc(target)}', file: '${esc(filePath)}'});
+  `;
+}
+export function listParticipantsScript(chatId) {
+    return `
+    const Messages = Application('Messages');
+    const chats = Messages.chats.whose({id: '${esc(chatId)}'})();
+    if (chats.length === 0) throw new Error('Chat not found: ${esc(chatId)}');
+    const chat = chats[0];
+    const participants = chat.participants();
+    const result = participants.map(p => ({
+      name: p.name(),
+      handle: p.handle()
+    }));
+    JSON.stringify({chatId: '${esc(chatId)}', chatName: chat.name() || null, participants: result});
+  `;
+}
+//# sourceMappingURL=scripts.js.map

package/dist/messages/scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../../src/messages/scripts.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEvC,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO;;;2CAGkC,KAAK;;;;;;;;;;;;;;;;GAgB7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO;;+CAEsC,GAAG,CAAC,MAAM,CAAC;+DACK,GAAG,CAAC,MAAM,CAAC;;;;;;;;;GASvE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,KAAa;IAEb,OAAO;;;iBAGQ,GAAG,CAAC,KAAK,CAAC;;;6BAGE,KAAK;;;;;;;;;;;;;;;;;GAiB/B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAAc,EACd,IAAY;IAEZ,OAAO;;;;oDAI2C,GAAG,CAAC,MAAM,CAAC;2EACY,GAAG,CAAC,MAAM,CAAC;qBACjE,GAAG,CAAC,IAAI,CAAC;uCACS,GAAG,CAAC,MAAM,CAAC,aAAa,GAAG,CAAC,IAAI,CAAC;GACrE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,QAAgB;IAEhB,OAAO;;;;oDAI2C,GAAG,CAAC,MAAM,CAAC;2EACY,GAAG,CAAC,MAAM,CAAC;yBAC7D,GAAG,CAAC,QAAQ,CAAC;;uCAEC,GAAG,CAAC,MAAM,CAAC,aAAa,GAAG,CAAC,QAAQ,CAAC;GACzE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,OAAO;;+CAEsC,GAAG,CAAC,MAAM,CAAC;+DACK,GAAG,CAAC,MAAM,CAAC;;;;;;;+BAO3C,GAAG,CAAC,MAAM,CAAC;GACvC,CAAC;AACJ,CAAC"}

package/dist/messages/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 registerMessagesTools(server: McpServer, _config: ImcpConfig): void;

package/dist/messages/tools.js

@@ -0,0 +1,100 @@
+import { z } from "zod";
+import { runJxa } from "../shared/jxa.js";
+import { ok, err } from "../shared/result.js";
+import { listChatsScript, readChatScript, searchMessagesScript, sendMessageScript, sendFileScript, listParticipantsScript, } from "./scripts.js";
+export function registerMessagesTools(server, _config) {
+    server.registerTool("list_chats", {
+        title: "List Chats",
+        description: "List recent chats in Messages with participants and last update time.",
+        inputSchema: {
+            limit: z.number().int().min(1).max(200).optional().default(50).describe("Max chats to return (default: 50)"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ limit }) => {
+        try {
+            return ok(await runJxa(listChatsScript(limit)));
+        }
+        catch (e) {
+            return err(`Failed to list chats: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("read_chat", {
+        title: "Read Chat",
+        description: "Read chat details including participants and last update time by chat ID.",
+        inputSchema: {
+            chatId: z.string().describe("Chat ID"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ chatId }) => {
+        try {
+            return ok(await runJxa(readChatScript(chatId)));
+        }
+        catch (e) {
+            return err(`Failed to read chat: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("search_chats", {
+        title: "Search Chats",
+        description: "Search chats by participant name, handle, or chat name.",
+        inputSchema: {
+            query: z.string().describe("Search keyword (matches chat name, participant name, or handle)"),
+            limit: z.number().int().min(1).max(100).optional().default(20).describe("Max results (default: 20)"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ query, limit }) => {
+        try {
+            return ok(await runJxa(searchMessagesScript(query, limit)));
+        }
+        catch (e) {
+            return err(`Failed to search chats: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("send_message", {
+        title: "Send Message",
+        description: "Send a text message via iMessage/SMS. Requires a phone number or email as the target handle.",
+        inputSchema: {
+            target: z.string().describe("Recipient handle (phone number or email, e.g. '+821012345678' or 'user@example.com')"),
+            text: z.string().min(1).max(10000).describe("Message text to send"),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    }, async ({ target, text }) => {
+        try {
+            return ok(await runJxa(sendMessageScript(target, text)));
+        }
+        catch (e) {
+            return err(`Failed to send message: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("send_file", {
+        title: "Send File",
+        description: "Send a file attachment via iMessage/SMS. Requires absolute file path and recipient handle.",
+        inputSchema: {
+            target: z.string().describe("Recipient handle (phone number or email)"),
+            filePath: z.string().describe("Absolute path to the file to send"),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    }, async ({ target, filePath }) => {
+        try {
+            return ok(await runJxa(sendFileScript(target, filePath)));
+        }
+        catch (e) {
+            return err(`Failed to send file: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.registerTool("list_participants", {
+        title: "List Chat Participants",
+        description: "List all participants in a specific chat.",
+        inputSchema: {
+            chatId: z.string().describe("Chat ID"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ chatId }) => {
+        try {
+            return ok(await runJxa(listParticipantsScript(chatId)));
+        }
+        catch (e) {
+            return err(`Failed to list participants: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/messages/tools.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@heznpc/imcp",
-  "version": "0.8.0",
-  "description": "MCP server for the entire Apple ecosystem — Notes, Reminders, Calendar, Contacts, Mail, Music, Finder, Safari, Photos, Shortcuts, System, and Apple Intelligence. Connect any AI to your Mac.",
+  "version": "0.9.0",
+  "description": "MCP server for the entire Apple ecosystem — Notes, Reminders, Calendar, Contacts, Mail, Messages, Music, Finder, Safari, Photos, Shortcuts, System, and Apple Intelligence. Connect any AI to your Mac.",
   "keywords": [
     "mcp",
     "model-context-protocol",
@@ -17,6 +17,8 @@
     "apple-contacts",
     "mail",
     "apple-mail",
+    "messages",
+    "imessage",
     "music",
     "apple-music",
     "finder",