ofw-mcp 1.4.1 → 1.5.0

package/dist/bundle.js

@@ -21054,6 +21054,19 @@ var toolDefinitions2 = [
       },
       required: ["messageId"]
     }
+  },
+  {
+    name: "ofw_get_unread_sent",
+    description: "List sent messages that have not been read by one or more recipients. Fetches sent messages page by page and returns only those with unread recipients.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      type: "object",
+      properties: {
+        page: { type: "number", description: "Page of sent messages to scan (default 1)" },
+        size: { type: "number", description: "Number of sent messages per page, max 50 (default 20)" }
+      },
+      required: []
+    }
   }
 ];
 async function handleTool2(name, args, client2) {
@@ -21119,6 +21132,35 @@ async function handleTool2(name, args, client2) {
       const data = await client2.request("DELETE", "/pub/v1/messages", form);
       return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
     }
+    case "ofw_get_unread_sent": {
+      const { page = 1, size = 20 } = args;
+      const folders = await client2.request(
+        "GET",
+        "/pub/v1/messageFolders?includeFolderCounts=true"
+      );
+      const sentFolder = folders.find((f) => f.folderType === "SENT_MESSAGES");
+      if (!sentFolder) throw new Error("Sent folder not found");
+      const listPath = `/pub/v3/messages?folders=${encodeURIComponent(sentFolder.id)}&page=${page}&size=${size}&sort=date&sortDirection=desc`;
+      const listData = await client2.request("GET", listPath);
+      const messages = listData.data ?? [];
+      const unread = [];
+      for (const msg of messages) {
+        const detail = await client2.request("GET", `/pub/v3/messages/${msg.id}`);
+        const unreadRecipients = (detail.recipients ?? []).filter((r) => !r.viewed).map((r) => r.user.name);
+        if (unreadRecipients.length > 0) {
+          unread.push({
+            id: detail.id,
+            subject: detail.subject,
+            sentAt: detail.date.dateTime,
+            unreadBy: unreadRecipients
+          });
+        }
+      }
+      if (unread.length === 0) {
+        return { content: [{ type: "text", text: JSON.stringify({ message: "All scanned sent messages have been read." }, null, 2) }] };
+      }
+      return { content: [{ type: "text", text: JSON.stringify(unread, null, 2) }] };
+    }
     default:
       throw new Error(`Unknown tool: ${name}`);
   }

package/dist/tools/messages.js

@@ -108,6 +108,19 @@ export const toolDefinitions = [
             required: ['messageId'],
         },
     },
+    {
+        name: 'ofw_get_unread_sent',
+        description: 'List sent messages that have not been read by one or more recipients. Fetches sent messages page by page and returns only those with unread recipients.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                page: { type: 'number', description: 'Page of sent messages to scan (default 1)' },
+                size: { type: 'number', description: 'Number of sent messages per page, max 50 (default 20)' },
+            },
+            required: [],
+        },
+    },
 ];
 export async function handleTool(name, args, client) {
     switch (name) {
@@ -170,6 +183,38 @@ export async function handleTool(name, args, client) {
             const data = await client.request('DELETE', '/pub/v1/messages', form);
             return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
         }
+        case 'ofw_get_unread_sent': {
+            const { page = 1, size = 20 } = args;
+            // Step 1: find the sent folder
+            const folders = await client.request('GET', '/pub/v1/messageFolders?includeFolderCounts=true');
+            const sentFolder = folders.find((f) => f.folderType === 'SENT_MESSAGES');
+            if (!sentFolder)
+                throw new Error('Sent folder not found');
+            // Step 2: list sent messages
+            const listPath = `/pub/v3/messages?folders=${encodeURIComponent(sentFolder.id)}&page=${page}&size=${size}&sort=date&sortDirection=desc`;
+            const listData = await client.request('GET', listPath);
+            const messages = listData.data ?? [];
+            // Step 3: fetch each message detail and filter to unread
+            const unread = [];
+            for (const msg of messages) {
+                const detail = await client.request('GET', `/pub/v3/messages/${msg.id}`);
+                const unreadRecipients = (detail.recipients ?? [])
+                    .filter((r) => !r.viewed)
+                    .map((r) => r.user.name);
+                if (unreadRecipients.length > 0) {
+                    unread.push({
+                        id: detail.id,
+                        subject: detail.subject,
+                        sentAt: detail.date.dateTime,
+                        unreadBy: unreadRecipients,
+                    });
+                }
+            }
+            if (unread.length === 0) {
+                return { content: [{ type: 'text', text: JSON.stringify({ message: 'All scanned sent messages have been read.' }, null, 2) }] };
+            }
+            return { content: [{ type: 'text', text: JSON.stringify(unread, null, 2) }] };
+        }
         default:
             throw new Error(`Unknown tool: ${name}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ofw-mcp",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "OurFamilyWizard MCP server for Claude — developed and maintained by AI (Claude Sonnet 4.6)",
   "author": "Claude Sonnet 4.6 (AI) <https://www.anthropic.com/claude>",
   "repository": {