icloud-mcp 2.5.0 → 2.7.0

package/lib/tools/reminders.js

@@ -0,0 +1,165 @@
+// iCloud Reminders (JXA) tools.
+import {
+  listReminderLists, listReminders, getReminder, createReminder, updateReminder, completeReminder, deleteReminder,
+  createReminderList, deleteReminderList, renameReminderList,
+} from '../reminders.js';
+
+
+export const reminderTools = [
+  // ── Reminders (JXA — real iCloud Reminders, not legacy CalDAV) ──
+  {
+    name: 'list_reminder_lists',
+    description: 'List all Reminders lists in iCloud Reminders (e.g. "Reminders", "Work", "Shopping"). Returns name, id, and count per list.',
+    inputSchema: { type: 'object', properties: {} }
+  },
+  {
+    name: 'create_reminder_list',
+    description: 'Create a new Reminders list in iCloud Reminders. Fails if a list with that name already exists.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'Name of the new list' }
+      },
+      required: ['name']
+    }
+  },
+  {
+    name: 'rename_reminder_list',
+    description: 'Rename a Reminders list. The old name must match exactly one list, and the new name must not already be in use.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        oldName: { type: 'string', description: 'Exact current name of the list' },
+        newName: { type: 'string', description: 'New name for the list' },
+        dryRun: { type: 'boolean', description: 'If true, report exactly what would change and do not modify anything' },
+      },
+      required: ['oldName', 'newName']
+    }
+  },
+  {
+    name: 'delete_reminder_list',
+    description: 'Delete a Reminders list. The list must be empty first, and the name must match exactly one list.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'Exact name of the list to delete' },
+        dryRun: { type: 'boolean', description: 'If true, report exactly what would change and do not modify anything' },
+      },
+      required: ['name']
+    }
+  },
+  {
+    name: 'list_reminders',
+    description: 'List reminders from iCloud Reminders. Omit listName to fetch from all lists.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        listName: { type: 'string', description: 'List name from list_reminder_lists (omit for all lists)' },
+        includeCompleted: { type: 'boolean', description: 'Include completed reminders (default false)' },
+        limit: { type: 'number', description: 'Max reminders to return (default 50)' }
+      }
+    }
+  },
+  {
+    name: 'get_reminder',
+    description: 'Get full details of a specific reminder by ID.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        listName: { type: 'string', description: 'List name containing the reminder' },
+        reminderId: { type: 'string', description: 'Reminder ID from list_reminders' }
+      },
+      required: ['listName', 'reminderId']
+    }
+  },
+  {
+    name: 'create_reminder',
+    description: 'Create a new reminder in iCloud Reminders.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        listName: { type: 'string', description: 'List name to add the reminder to (required)' },
+        title: { type: 'string', description: 'Reminder title' },
+        notes: { type: 'string', description: 'Notes / description' },
+        due: { type: 'string', description: 'Due date/time — ISO 8601 (e.g. 2026-03-20T09:00:00)' },
+        priority: { type: 'string', description: 'Priority: high, medium, low, or none (default none)' }
+      },
+      required: ['listName', 'title']
+    }
+  },
+  {
+    name: 'update_reminder',
+    description: 'Update an existing reminder. Only provided fields are changed; others are preserved.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        listName: { type: 'string', description: 'List name containing the reminder' },
+        reminderId: { type: 'string', description: 'Reminder ID to update' },
+        title: { type: 'string' },
+        notes: { type: 'string' },
+        due: { type: 'string' },
+        priority: { type: 'string', description: 'high, medium, low, or none' }
+      },
+      required: ['listName', 'reminderId']
+    }
+  },
+  {
+    name: 'complete_reminder',
+    description: 'Mark a reminder as completed in iCloud Reminders.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        listName: { type: 'string', description: 'List name containing the reminder' },
+        reminderId: { type: 'string', description: 'Reminder ID to mark as completed' }
+      },
+      required: ['listName', 'reminderId']
+    }
+  },
+  {
+    name: 'delete_reminder',
+    description: 'Delete a reminder from iCloud Reminders permanently.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        listName: { type: 'string', description: 'List name containing the reminder' },
+        reminderId: { type: 'string', description: 'Reminder ID to delete' },
+        dryRun: { type: 'boolean', description: 'If true, report exactly what would change and do not modify anything' },
+      },
+      required: ['listName', 'reminderId']
+    }
+  },
+];
+
+const _reminderTools_NAMES = new Set(reminderTools.map((tool) => tool.name));
+
+export async function handleReminderTool(name, args, ctx) {
+  if (!_reminderTools_NAMES.has(name)) return undefined;
+  const { resolveCreds, resolveMailbox, accounts: ACCOUNTS } = ctx;
+  let result;
+  if (name === 'list_reminder_lists') {
+    result = listReminderLists();
+  } else if (name === 'create_reminder_list') {
+    result = createReminderList(args.name);
+  } else if (name === 'rename_reminder_list') {
+    result = renameReminderList(args.oldName, args.newName, args.dryRun || false);
+  } else if (name === 'delete_reminder_list') {
+    result = deleteReminderList(args.name, args.dryRun || false);
+  } else if (name === 'list_reminders') {
+    result = listReminders(args.listName || null, args.includeCompleted || false, args.limit || 50);
+  } else if (name === 'get_reminder') {
+    result = getReminder(args.listName, args.reminderId);
+  } else if (name === 'create_reminder') {
+    const { listName, ...fields } = args;
+    result = createReminder(listName, fields);
+  } else if (name === 'update_reminder') {
+    const { listName, reminderId, ...fields } = args;
+    result = updateReminder(listName, reminderId, fields);
+  } else if (name === 'complete_reminder') {
+    result = completeReminder(args.listName, args.reminderId);
+  } else if (name === 'delete_reminder') {
+    result = deleteReminder(args.listName, args.reminderId, args.dryRun || false);
+  // ── Smart extraction (SCAN tier 60s — LLM round-trip) ──
+  }
+  return result;
+}
+

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "icloud-mcp",
-  "version": "2.5.0",
-  "description": "A Model Context Protocol (MCP) server for iCloud Mail",
+  "version": "2.7.0",
+  "description": "Maintained Model Context Protocol (MCP) server for iCloud Mail, Contacts, Calendar, and Reminders",
   "main": "index.js",
   "bin": {
-    "icloud-mcp": "./index.js"
+    "icloud-mcp": "index.js"
   },
   "type": "module",
   "scripts": {
     "start": "node index.js",
-    "test": "node tests/test.js"
+    "test": "node --test tests/dry-run.test.js tests/send-guard.test.js tests/pr-claims.test.js",
+    "test:live": "ICLOUD_MCP_LIVE=1 node tests/live-destructive.test.js",
+    "test:send": "node tests/test.js"
   },
   "keywords": [
     "mcp",
@@ -20,10 +22,27 @@
   ],
   "author": "Adam Zaidi",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adamzaidi/icloud-mcp.git"
+  },
+  "homepage": "https://github.com/adamzaidi/icloud-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/adamzaidi/icloud-mcp/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "index.js",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "fast-xml-parser": "^5.4.2",
-    "imapflow": "^1.2.10",
-    "nodemailer": "^8.0.2"
+    "fast-xml-parser": "^5.8.0",
+    "imapflow": "^1.3.3",
+    "nodemailer": "^8.0.9"
   }
 }

package/.claude/scheduled_tasks.lock

@@ -1 +0,0 @@
-{"sessionId":"583b9a47-29dc-4265-b2f0-dc31dbbd06c3","pid":81825,"acquiredAt":1773517693304}

package/.claude/settings.local.json

@@ -1,35 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "mcp__icloud-mail__list_mailboxes",
-      "mcp__icloud-mail__get_top_senders",
-      "mcp__icloud-mail__get_unread_senders",
-      "mcp__icloud-mail__get_storage_report",
-      "mcp__icloud-mail__get_mailbox_summary",
-      "mcp__icloud-mail__create_mailbox",
-      "mcp__icloud-mail__bulk_move",
-      "mcp__icloud-mail__delete_mailbox",
-      "mcp__icloud-mail__get_inbox_summary",
-      "mcp__icloud-mail__abandon_move",
-      "mcp__icloud-mail__search_emails",
-      "mcp__icloud-mail__count_emails",
-      "mcp__icloud-mail__archive_older_than",
-      "mcp__icloud-mail__bulk_move_by_sender",
-      "mcp__icloud-mail__get_move_status",
-      "mcp__icloud-mail__bulk_move_by_domain",
-      "WebSearch",
-      "WebFetch(domain:www.mdcourts.gov)",
-      "WebFetch(domain:probonomd.org)",
-      "WebFetch(domain:www.courts.state.md.us)",
-      "WebFetch(domain:msa.maryland.gov)",
-      "WebFetch(domain:www.harford.edu)",
-      "WebFetch(domain:thedailyrecord.com)",
-      "WebFetch(domain:ballotpedia.org)",
-      "mcp__icloud-mail__compose_email"
-    ]
-  },
-  "enableAllProjectMcpServers": true,
-  "enabledMcpjsonServers": [
-    "icloud-mail"
-  ]
-}

package/.mcp.json.example

@@ -1,12 +0,0 @@
-{
-  "mcpServers": {
-    "icloud-mail": {
-      "command": "node",
-      "args": ["./index.js"],
-      "env": {
-        "IMAP_USER": "${ICLOUD_EMAIL}",
-        "IMAP_PASSWORD": "${ICLOUD_APP_PASSWORD}"
-      }
-    }
-  }
-}

package/run-digest.js

@@ -1,57 +0,0 @@
-#!/usr/bin/env node
-// ─── Inbox Intelligence — Digest Status Helper ────────────────────────────────
-// Shows current digest state and what's pending. Not the runner itself —
-// Claude Code is the runner. Use this to inspect state or reset it.
-//
-// Usage:
-//   node run-digest.js            → show current state
-//   node run-digest.js --reset    → clear all processed UIDs and state
-
-import { getDigestState, updateDigestState } from './lib/digest.js';
-
-const args = process.argv.slice(2);
-
-if (args.includes('--reset')) {
-  updateDigestState({
-    lastRun: null,
-    processedUids: [],
-    pendingActions: [],
-    skipCounts: {}
-  });
-  // Force full reset by re-reading and overwriting
-  const { writeFileSync } = await import('fs');
-  const { homedir } = await import('os');
-  const { join } = await import('path');
-  writeFileSync(
-    join(homedir(), '.icloud-mcp-digest.json'),
-    JSON.stringify({ lastRun: null, processedUids: [], pendingActions: [], skipCounts: {} }, null, 2)
-  );
-  console.log('✓ Digest state reset.');
-  process.exit(0);
-}
-
-const state = getDigestState();
-
-console.log('\n── Digest State ──────────────────────────────────────────');
-console.log(`Last run:          ${state.lastRun ? new Date(state.lastRun).toLocaleString() : 'never'}`);
-console.log(`Processed UIDs:    ${state.processedUids.length}`);
-console.log(`Pending actions:   ${state.pendingActions.length}`);
-
-if (state.pendingActions.length > 0) {
-  for (const a of state.pendingActions) {
-    console.log(`  • [${a.type}] ${a.subject}${a.dueDate ? ' — due ' + a.dueDate : ''}`);
-  }
-}
-
-const candidates = Object.entries(state.skipCounts)
-  .filter(([, c]) => c >= 3)
-  .sort((a, b) => b[1] - a[1]);
-
-if (candidates.length > 0) {
-  console.log(`\nUnsubscribe candidates (skipped 3+ times):`);
-  for (const [sender, count] of candidates) {
-    console.log(`  • ${sender} (${count}×)`);
-  }
-}
-
-console.log('──────────────────────────────────────────────────────────\n');