ofw-mcp 2.0.9 → 2.0.11

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "OurFamilyWizard tools for Claude Code",
-    "version": "2.0.9"
+    "version": "2.0.11"
   },
   "plugins": [
     {
@@ -14,7 +14,7 @@
       "displayName": "OurFamilyWizard",
       "source": "./",
       "description": "OurFamilyWizard co-parenting tools for Claude — messages, calendar, expenses, and journal via MCP",
-      "version": "2.0.9",
+      "version": "2.0.11",
       "author": {
         "name": "Chris Chall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ofw",
   "displayName": "OurFamilyWizard",
-  "version": "2.0.9",
+  "version": "2.0.11",
   "description": "OurFamilyWizard co-parenting tools for Claude — messages, calendar, expenses, and journal via MCP",
   "author": {
     "name": "Chris Chall"

package/dist/bundle.js

@@ -31379,12 +31379,14 @@ function listAttachmentsForMessage(messageId) {
 function upsertAttachmentForMessage(input) {
   const { db } = openCache();
   const existing = db.prepare("SELECT message_ids_json FROM attachments WHERE file_id = ?").get(input.fileId);
+  const prior = existing ? JSON.parse(existing.message_ids_json) : [];
   let messageIds;
-  if (existing) {
-    const arr = JSON.parse(existing.message_ids_json);
-    messageIds = arr.includes(input.messageId) ? arr : [...arr, input.messageId];
+  if (input.messageId === 0) {
+    messageIds = prior;
+  } else if (prior.includes(input.messageId)) {
+    messageIds = prior;
   } else {
-    messageIds = [input.messageId];
+    messageIds = [...prior, input.messageId];
   }
   db.prepare(
     `INSERT INTO attachments (
@@ -31592,8 +31594,42 @@ async function syncAll(client2, opts) {
 }
 
 // src/tools/messages.ts
-import { mkdirSync as mkdirSync2, writeFileSync } from "node:fs";
-import { dirname as dirname3, join as join3, isAbsolute, resolve } from "node:path";
+import { mkdirSync as mkdirSync2, readFileSync, statSync, writeFileSync } from "node:fs";
+import { basename, dirname as dirname3, extname, join as join3, isAbsolute, resolve } from "node:path";
+var MIME_BY_EXT = {
+  ".pdf": "application/pdf",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".heic": "image/heic",
+  ".txt": "text/plain",
+  ".md": "text/markdown",
+  ".csv": "text/csv",
+  ".html": "text/html",
+  ".htm": "text/html",
+  ".json": "application/json",
+  ".xml": "application/xml",
+  ".doc": "application/msword",
+  ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  ".xls": "application/vnd.ms-excel",
+  ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  ".ppt": "application/vnd.ms-powerpoint",
+  ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+  ".zip": "application/zip",
+  ".ics": "text/calendar"
+};
+function mimeFromName(name) {
+  return MIME_BY_EXT[extname(name).toLowerCase()] ?? "application/octet-stream";
+}
+function listDataHintsAtFiles(listData) {
+  if (typeof listData !== "object" || listData === null) return false;
+  const ld = listData;
+  if (typeof ld.files === "number") return ld.files > 0;
+  if (Array.isArray(ld.files)) return ld.files.length > 0;
+  return false;
+}
 function registerMessageTools(server2, client2) {
   server2.registerTool("ofw_list_message_folders", {
     description: "List OurFamilyWizard message folders (inbox, sent, etc.) and their unread counts. Returns folder IDs needed to call ofw_list_messages. Does NOT return message content.",
@@ -31653,7 +31689,17 @@ function registerMessageTools(server2, client2) {
     const id = Number(args.messageId);
     const cached2 = getMessage(id);
     if (cached2 && cached2.body !== null) {
-      const attachments2 = listAttachmentsForMessage(id);
+      let attachments2 = listAttachmentsForMessage(id);
+      if (attachments2.length === 0 && listDataHintsAtFiles(cached2.listData)) {
+        try {
+          const detail2 = await client2.request("GET", `/pub/v3/messages/${id}`);
+          if (Array.isArray(detail2.files) && detail2.files.length > 0) {
+            await fetchAttachmentMetaForMessage(client2, id, detail2.files);
+            attachments2 = listAttachmentsForMessage(id);
+          }
+        } catch {
+        }
+      }
       return { content: [{ type: "text", text: JSON.stringify({ ...cached2, attachments: attachments2 }, null, 2) }] };
     }
     const detail = await client2.request("GET", `/pub/v3/messages/${encodeURIComponent(args.messageId)}`);
@@ -31684,14 +31730,15 @@ function registerMessageTools(server2, client2) {
     return { content: [{ type: "text", text: JSON.stringify({ ...row, attachments }, null, 2) }] };
   });
   server2.registerTool("ofw_send_message", {
-    description: "Send a message via OurFamilyWizard. If sending from a draft, pass draftId to delete the draft after sending. If replyToId is provided, the cache may rewrite it to the latest reply in the same thread (a note is included in the response when this happens).",
+    description: "Send a message via OurFamilyWizard. If sending from a draft, pass draftId to delete the draft after sending. If replyToId is provided, the cache may rewrite it to the latest reply in the same thread (a note is included in the response when this happens). Attach files by passing their fileIds (from ofw_upload_attachment) in myFileIDs.",
     annotations: { destructiveHint: true },
     inputSchema: {
       subject: external_exports.string().describe("Message subject"),
       body: external_exports.string().describe("Message body text"),
       recipientIds: external_exports.array(external_exports.number()).describe("Array of recipient user IDs (get from ofw_get_profile)"),
       replyToId: external_exports.number().describe("ID of the message being replied to").optional(),
-      draftId: external_exports.number().describe("ID of the draft to delete after sending (omit if not sending from a draft)").optional()
+      draftId: external_exports.number().describe("ID of the draft to delete after sending (omit if not sending from a draft)").optional(),
+      myFileIDs: external_exports.array(external_exports.number()).describe("Attachment file ids (from ofw_upload_attachment) to attach to the message").optional()
     }
   }, async (args) => {
     const requestedReplyTo = args.replyToId ?? null;
@@ -31706,11 +31753,12 @@ function registerMessageTools(server2, client2) {
       const parent = getMessage(resolvedReplyTo);
       chainRootId = parent?.chainRootId ?? parent?.id ?? requestedReplyTo;
     }
+    const myFileIDs = args.myFileIDs ?? [];
     const data = await client2.request("POST", "/pub/v3/messages", {
       subject: args.subject,
       body: args.body,
       recipientIds: args.recipientIds,
-      attachments: { myFileIDs: [] },
+      attachments: { myFileIDs },
       draft: false,
       includeOriginal: resolvedReplyTo !== null,
       replyToId: resolvedReplyTo
@@ -31735,6 +31783,18 @@ function registerMessageTools(server2, client2) {
         listData: data
       };
       upsertMessage(row);
+      for (const fileId of myFileIDs) {
+        const existing = getAttachment(fileId);
+        upsertAttachmentForMessage({
+          fileId,
+          fileName: existing?.fileName ?? `file-${fileId}`,
+          label: existing?.label ?? existing?.fileName ?? `file-${fileId}`,
+          mimeType: existing?.mimeType ?? "application/octet-stream",
+          sizeBytes: existing?.sizeBytes ?? null,
+          metadata: existing?.metadata ?? {},
+          messageId: data.id
+        });
+      }
     }
     if (args.draftId !== void 0) {
       const form = new FormData();
@@ -31763,14 +31823,15 @@ ${text}` : text;
     return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
   });
   server2.registerTool("ofw_save_draft", {
-    description: "Save a message as a draft in OurFamilyWizard. Recipients are optional. To update an existing draft, provide its messageId. If replyToId is provided, the cache may rewrite it to the latest reply in the thread (note included in response).",
+    description: "Save a message as a draft in OurFamilyWizard. Recipients are optional. To update an existing draft, provide its messageId. If replyToId is provided, the cache may rewrite it to the latest reply in the thread (note included in response). Attach files by passing their fileIds (from ofw_upload_attachment) in myFileIDs.",
     annotations: { readOnlyHint: false },
     inputSchema: {
       subject: external_exports.string().describe("Message subject"),
       body: external_exports.string().describe("Message body text"),
       recipientIds: external_exports.array(external_exports.number()).describe("Array of recipient user IDs (optional for drafts)").optional(),
       messageId: external_exports.number().describe("ID of an existing draft to update (omit to create a new draft)").optional(),
-      replyToId: external_exports.number().describe("ID of the message this draft replies to").optional()
+      replyToId: external_exports.number().describe("ID of the message this draft replies to").optional(),
+      myFileIDs: external_exports.array(external_exports.number()).describe("Attachment file ids (from ofw_upload_attachment)").optional()
     }
   }, async (args) => {
     const requestedReplyTo = args.replyToId ?? null;
@@ -31782,11 +31843,12 @@ ${text}` : text;
         rewriteNote = `replyToId rewritten from ${requestedReplyTo} to ${resolvedReplyTo} (later reply in same thread found in sent cache).`;
       }
     }
+    const myFileIDs = args.myFileIDs ?? [];
     const payload = {
       subject: args.subject,
       body: args.body,
       recipientIds: args.recipientIds ?? [],
-      attachments: { myFileIDs: [] },
+      attachments: { myFileIDs },
       draft: true,
       includeOriginal: resolvedReplyTo !== null,
       replyToId: resolvedReplyTo
@@ -31858,6 +31920,49 @@ ${text}` : text;
     }
     return { content: [{ type: "text", text: JSON.stringify(unread, null, 2) }] };
   });
+  server2.registerTool("ofw_upload_attachment", {
+    description: `Upload a local file to OurFamilyWizard's "My Files" so it can be attached to a message. Returns the fileId \u2014 pass that to ofw_send_message or ofw_save_draft in myFileIDs to attach it. The file is uploaded as PRIVATE (visible only to you) by default; pass shareClass:"SHARED" to share with co-parents directly via the My Files area.`,
+    annotations: { destructiveHint: false },
+    inputSchema: {
+      path: external_exports.string().describe("Absolute path to the local file to upload. Tilde (~) is expanded."),
+      shareClass: external_exports.enum(["PRIVATE", "SHARED"]).describe("Share class (default PRIVATE)").optional(),
+      label: external_exports.string().describe("Display label for the file in OFW (default: filename)").optional(),
+      description: external_exports.string().describe("Description shown in OFW My Files (default: filename)").optional()
+    }
+  }, async (args) => {
+    const expanded = args.path.startsWith("~/") ? join3(process.env.HOME ?? "", args.path.slice(2)) : args.path;
+    const abs = isAbsolute(expanded) ? expanded : resolve(expanded);
+    const stat = statSync(abs);
+    if (!stat.isFile()) throw new Error(`Not a file: ${abs}`);
+    const buf = readFileSync(abs);
+    const fileName = basename(abs);
+    const mime = mimeFromName(fileName);
+    const form = new FormData();
+    form.append("file", new Blob([new Uint8Array(buf)], { type: mime }), fileName);
+    form.append("source", "message");
+    form.append("description", args.description ?? fileName);
+    form.append("label", args.label ?? fileName);
+    form.append("fileName", fileName);
+    form.append("shareClass", args.shareClass ?? "PRIVATE");
+    const meta3 = await client2.request("POST", "/pub/v3/myfiles/multipart", form);
+    upsertAttachmentForMessage({
+      fileId: meta3.fileId,
+      fileName: meta3.fileName ?? fileName,
+      label: meta3.label ?? args.label ?? fileName,
+      mimeType: meta3.fileType ?? mime,
+      sizeBytes: typeof meta3.sizeInBytes === "number" ? meta3.sizeInBytes : buf.length,
+      metadata: meta3,
+      messageId: 0
+    });
+    return { content: [{ type: "text", text: JSON.stringify({
+      fileId: meta3.fileId,
+      fileName: meta3.fileName ?? fileName,
+      mimeType: meta3.fileType ?? mime,
+      sizeBytes: meta3.sizeInBytes ?? buf.length,
+      shareClass: meta3.shareClass ?? args.shareClass ?? "PRIVATE",
+      note: "Pass this fileId to ofw_send_message or ofw_save_draft in myFileIDs to attach it."
+    }, null, 2) }] };
+  });
   server2.registerTool("ofw_download_attachment", {
     description: "Download an OFW message attachment by fileId. Bytes are saved to disk; the tool returns the absolute path, mime type, and size so the caller can then read/analyze the file. fileId comes from the attachments array on ofw_get_message. Saves under ~/.cache/ofw-mcp/attachments/<hash>/ by default (override via OFW_ATTACHMENTS_DIR or the saveTo argument). Re-downloading is a no-op if the file is already on disk.",
     annotations: { readOnlyHint: false },
@@ -32075,7 +32180,7 @@ process.emit = function(event, ...args) {
   }
   return originalEmit(event, ...args);
 };
-var server = new McpServer({ name: "ofw", version: "2.0.9" });
+var server = new McpServer({ name: "ofw", version: "2.0.11" });
 registerUserTools(server, client);
 registerMessageTools(server, client);
 registerCalendarTools(server, client);

package/dist/cache.js

@@ -295,13 +295,19 @@ export function upsertAttachmentForMessage(input) {
     const { db } = openCache();
     const existing = db.prepare('SELECT message_ids_json FROM attachments WHERE file_id = ?')
         .get(input.fileId);
+    // messageId === 0 is the "metadata-only, not yet linked to a message"
+    // sentinel used by upload-without-send and download-by-id. Don't
+    // pollute the array with it — leave the list empty / unchanged.
+    const prior = existing ? JSON.parse(existing.message_ids_json) : [];
     let messageIds;
-    if (existing) {
-        const arr = JSON.parse(existing.message_ids_json);
-        messageIds = arr.includes(input.messageId) ? arr : [...arr, input.messageId];
+    if (input.messageId === 0) {
+        messageIds = prior;
+    }
+    else if (prior.includes(input.messageId)) {
+        messageIds = prior;
     }
     else {
-        messageIds = [input.messageId];
+        messageIds = [...prior, input.messageId];
     }
     db.prepare(`INSERT INTO attachments (
        file_id, file_name, label, mime_type, size_bytes,

package/dist/index.js

@@ -17,7 +17,7 @@ import { registerMessageTools } from './tools/messages.js';
 import { registerCalendarTools } from './tools/calendar.js';
 import { registerExpenseTools } from './tools/expenses.js';
 import { registerJournalTools } from './tools/journal.js';
-const server = new McpServer({ name: 'ofw', version: '2.0.9' });
+const server = new McpServer({ name: 'ofw', version: '2.0.11' });
 registerUserTools(server, client);
 registerMessageTools(server, client);
 registerCalendarTools(server, client);

package/dist/tools/messages.js

@@ -2,8 +2,49 @@ import { z } from 'zod';
 import { syncAll, fetchAttachmentMetaForMessage } from '../sync.js';
 import { listMessages, countMessages, listDrafts, getMessage, upsertMessage, upsertDraft, deleteDraft, findLatestReplyTip, listAttachmentsForMessage, getAttachment, upsertAttachmentForMessage, markAttachmentDownloaded, } from '../cache.js';
 import { getAttachmentsDir } from '../config.js';
-import { mkdirSync, writeFileSync } from 'node:fs';
-import { dirname, join, isAbsolute, resolve } from 'node:path';
+import { mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { basename, dirname, extname, join, isAbsolute, resolve } from 'node:path';
+// Lightweight mime sniff from extension. OFW re-derives mime from the filename
+// server-side anyway, so this is just a polite Content-Type for the Blob.
+const MIME_BY_EXT = {
+    '.pdf': 'application/pdf',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.heic': 'image/heic',
+    '.txt': 'text/plain',
+    '.md': 'text/markdown',
+    '.csv': 'text/csv',
+    '.html': 'text/html', '.htm': 'text/html',
+    '.json': 'application/json',
+    '.xml': 'application/xml',
+    '.doc': 'application/msword',
+    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.xls': 'application/vnd.ms-excel',
+    '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    '.ppt': 'application/vnd.ms-powerpoint',
+    '.pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+    '.zip': 'application/zip',
+    '.ics': 'text/calendar',
+};
+function mimeFromName(name) {
+    return MIME_BY_EXT[extname(name).toLowerCase()] ?? 'application/octet-stream';
+}
+// The list endpoint payload (cached as `listData`) reports attachments via
+// `files: <count>` (a number) — the actual fileIds only appear on the detail
+// endpoint as `files: [number, ...]`. Some intermediate shapes return an
+// array on the list too. Treat any of those as "this message has files".
+function listDataHintsAtFiles(listData) {
+    if (typeof listData !== 'object' || listData === null)
+        return false;
+    const ld = listData;
+    if (typeof ld.files === 'number')
+        return ld.files > 0;
+    if (Array.isArray(ld.files))
+        return ld.files.length > 0;
+    return false;
+}
 export function registerMessageTools(server, client) {
     server.registerTool('ofw_list_message_folders', {
         description: 'List OurFamilyWizard message folders (inbox, sent, etc.) and their unread counts. Returns folder IDs needed to call ofw_list_messages. Does NOT return message content.',
@@ -67,7 +108,26 @@ export function registerMessageTools(server, client) {
         const id = Number(args.messageId);
         const cached = getMessage(id);
         if (cached && cached.body !== null) {
-            const attachments = listAttachmentsForMessage(id);
+            let attachments = listAttachmentsForMessage(id);
+            // Lazy attachment backfill. The list-endpoint payload (stored in
+            // listData) hints at attachments via `files: <count>` but doesn't
+            // expose the fileIds — those live only on /pub/v3/messages/{id}.
+            // For messages bodied before attachment caching existed, the
+            // attachments table is empty even though OFW has files. Re-hit
+            // detail to harvest fileIds (idempotent: body is already cached so
+            // OFW state isn't changing).
+            if (attachments.length === 0 && listDataHintsAtFiles(cached.listData)) {
+                try {
+                    const detail = await client.request('GET', `/pub/v3/messages/${id}`);
+                    if (Array.isArray(detail.files) && detail.files.length > 0) {
+                        await fetchAttachmentMetaForMessage(client, id, detail.files);
+                        attachments = listAttachmentsForMessage(id);
+                    }
+                }
+                catch {
+                    // Backfill is best-effort. Fall through with whatever we have.
+                }
+            }
             return { content: [{ type: 'text', text: JSON.stringify({ ...cached, attachments }, null, 2) }] };
         }
         const detail = await client.request('GET', `/pub/v3/messages/${encodeURIComponent(args.messageId)}`);
@@ -96,7 +156,7 @@ export function registerMessageTools(server, client) {
         return { content: [{ type: 'text', text: JSON.stringify({ ...row, attachments }, null, 2) }] };
     });
     server.registerTool('ofw_send_message', {
-        description: 'Send a message via OurFamilyWizard. If sending from a draft, pass draftId to delete the draft after sending. If replyToId is provided, the cache may rewrite it to the latest reply in the same thread (a note is included in the response when this happens).',
+        description: 'Send a message via OurFamilyWizard. If sending from a draft, pass draftId to delete the draft after sending. If replyToId is provided, the cache may rewrite it to the latest reply in the same thread (a note is included in the response when this happens). Attach files by passing their fileIds (from ofw_upload_attachment) in myFileIDs.',
         annotations: { destructiveHint: true },
         inputSchema: {
             subject: z.string().describe('Message subject'),
@@ -104,6 +164,7 @@ export function registerMessageTools(server, client) {
             recipientIds: z.array(z.number()).describe('Array of recipient user IDs (get from ofw_get_profile)'),
             replyToId: z.number().describe('ID of the message being replied to').optional(),
             draftId: z.number().describe('ID of the draft to delete after sending (omit if not sending from a draft)').optional(),
+            myFileIDs: z.array(z.number()).describe('Attachment file ids (from ofw_upload_attachment) to attach to the message').optional(),
         },
     }, async (args) => {
         const requestedReplyTo = args.replyToId ?? null;
@@ -118,11 +179,12 @@ export function registerMessageTools(server, client) {
             const parent = getMessage(resolvedReplyTo);
             chainRootId = parent?.chainRootId ?? parent?.id ?? requestedReplyTo;
         }
+        const myFileIDs = args.myFileIDs ?? [];
         const data = await client.request('POST', '/pub/v3/messages', {
             subject: args.subject,
             body: args.body,
             recipientIds: args.recipientIds,
-            attachments: { myFileIDs: [] },
+            attachments: { myFileIDs },
             draft: false,
             includeOriginal: resolvedReplyTo !== null,
             replyToId: resolvedReplyTo,
@@ -145,6 +207,21 @@ export function registerMessageTools(server, client) {
                 listData: data,
             };
             upsertMessage(row);
+            // Link attached files to the new message in the attachments cache.
+            // We may not have full metadata if the upload happened in a prior
+            // session — fall back to what we know.
+            for (const fileId of myFileIDs) {
+                const existing = getAttachment(fileId);
+                upsertAttachmentForMessage({
+                    fileId,
+                    fileName: existing?.fileName ?? `file-${fileId}`,
+                    label: existing?.label ?? existing?.fileName ?? `file-${fileId}`,
+                    mimeType: existing?.mimeType ?? 'application/octet-stream',
+                    sizeBytes: existing?.sizeBytes ?? null,
+                    metadata: existing?.metadata ?? {},
+                    messageId: data.id,
+                });
+            }
         }
         if (args.draftId !== undefined) {
             const form = new FormData();
@@ -173,7 +250,7 @@ export function registerMessageTools(server, client) {
         return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
     });
     server.registerTool('ofw_save_draft', {
-        description: 'Save a message as a draft in OurFamilyWizard. Recipients are optional. To update an existing draft, provide its messageId. If replyToId is provided, the cache may rewrite it to the latest reply in the thread (note included in response).',
+        description: 'Save a message as a draft in OurFamilyWizard. Recipients are optional. To update an existing draft, provide its messageId. If replyToId is provided, the cache may rewrite it to the latest reply in the thread (note included in response). Attach files by passing their fileIds (from ofw_upload_attachment) in myFileIDs.',
         annotations: { readOnlyHint: false },
         inputSchema: {
             subject: z.string().describe('Message subject'),
@@ -181,6 +258,7 @@ export function registerMessageTools(server, client) {
             recipientIds: z.array(z.number()).describe('Array of recipient user IDs (optional for drafts)').optional(),
             messageId: z.number().describe('ID of an existing draft to update (omit to create a new draft)').optional(),
             replyToId: z.number().describe('ID of the message this draft replies to').optional(),
+            myFileIDs: z.array(z.number()).describe('Attachment file ids (from ofw_upload_attachment)').optional(),
         },
     }, async (args) => {
         const requestedReplyTo = args.replyToId ?? null;
@@ -192,11 +270,12 @@ export function registerMessageTools(server, client) {
                 rewriteNote = `replyToId rewritten from ${requestedReplyTo} to ${resolvedReplyTo} (later reply in same thread found in sent cache).`;
             }
         }
+        const myFileIDs = args.myFileIDs ?? [];
         const payload = {
             subject: args.subject,
             body: args.body,
             recipientIds: args.recipientIds ?? [],
-            attachments: { myFileIDs: [] },
+            attachments: { myFileIDs },
             draft: true,
             includeOriginal: resolvedReplyTo !== null,
             replyToId: resolvedReplyTo,
@@ -265,6 +344,58 @@ export function registerMessageTools(server, client) {
         }
         return { content: [{ type: 'text', text: JSON.stringify(unread, null, 2) }] };
     });
+    server.registerTool('ofw_upload_attachment', {
+        description: 'Upload a local file to OurFamilyWizard\'s "My Files" so it can be attached to a message. Returns the fileId — pass that to ofw_send_message or ofw_save_draft in myFileIDs to attach it. The file is uploaded as PRIVATE (visible only to you) by default; pass shareClass:"SHARED" to share with co-parents directly via the My Files area.',
+        annotations: { destructiveHint: false },
+        inputSchema: {
+            path: z.string().describe('Absolute path to the local file to upload. Tilde (~) is expanded.'),
+            shareClass: z.enum(['PRIVATE', 'SHARED']).describe('Share class (default PRIVATE)').optional(),
+            label: z.string().describe('Display label for the file in OFW (default: filename)').optional(),
+            description: z.string().describe('Description shown in OFW My Files (default: filename)').optional(),
+        },
+    }, async (args) => {
+        // Resolve and read the local file
+        const expanded = args.path.startsWith('~/')
+            ? join(process.env.HOME ?? '', args.path.slice(2))
+            : args.path;
+        const abs = isAbsolute(expanded) ? expanded : resolve(expanded);
+        const stat = statSync(abs); // throws if missing
+        if (!stat.isFile())
+            throw new Error(`Not a file: ${abs}`);
+        const buf = readFileSync(abs);
+        const fileName = basename(abs);
+        const mime = mimeFromName(fileName);
+        // Build the multipart payload matching the OFW web UI's request shape
+        const form = new FormData();
+        form.append('file', new Blob([new Uint8Array(buf)], { type: mime }), fileName);
+        form.append('source', 'message');
+        form.append('description', args.description ?? fileName);
+        form.append('label', args.label ?? fileName);
+        form.append('fileName', fileName);
+        form.append('shareClass', args.shareClass ?? 'PRIVATE');
+        const meta = await client.request('POST', '/pub/v3/myfiles/multipart', form);
+        // Cache the metadata so subsequent ofw_get_message calls can surface it
+        // and ofw_download_attachment short-circuits if asked. messageId is 0
+        // because no message references this yet — it'll be linked once a
+        // message is sent with this fileId in its attachments.
+        upsertAttachmentForMessage({
+            fileId: meta.fileId,
+            fileName: meta.fileName ?? fileName,
+            label: meta.label ?? args.label ?? fileName,
+            mimeType: meta.fileType ?? mime,
+            sizeBytes: typeof meta.sizeInBytes === 'number' ? meta.sizeInBytes : buf.length,
+            metadata: meta,
+            messageId: 0,
+        });
+        return { content: [{ type: 'text', text: JSON.stringify({
+                        fileId: meta.fileId,
+                        fileName: meta.fileName ?? fileName,
+                        mimeType: meta.fileType ?? mime,
+                        sizeBytes: meta.sizeInBytes ?? buf.length,
+                        shareClass: meta.shareClass ?? args.shareClass ?? 'PRIVATE',
+                        note: 'Pass this fileId to ofw_send_message or ofw_save_draft in myFileIDs to attach it.',
+                    }, null, 2) }] };
+    });
     server.registerTool('ofw_download_attachment', {
         description: 'Download an OFW message attachment by fileId. Bytes are saved to disk; the tool returns the absolute path, mime type, and size so the caller can then read/analyze the file. fileId comes from the attachments array on ofw_get_message. Saves under ~/.cache/ofw-mcp/attachments/<hash>/ by default (override via OFW_ATTACHMENTS_DIR or the saveTo argument). Re-downloading is a no-op if the file is already on disk.',
         annotations: { readOnlyHint: false },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ofw-mcp",
-  "version": "2.0.9",
+  "version": "2.0.11",
   "mcpName": "io.github.chrischall/ofw-mcp",
   "description": "OurFamilyWizard MCP server for Claude — developed and maintained by AI (Claude Code)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/ofw-mcp",
     "source": "github"
   },
-  "version": "2.0.9",
+  "version": "2.0.11",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "ofw-mcp",
-      "version": "2.0.9",
+      "version": "2.0.11",
       "transport": {
         "type": "stdio"
       },