@scardis/omnifocus-mcp 0.1.0

package/src/snippets/edit_task.js

@@ -0,0 +1,146 @@
+/**
+ * edit_task.js — Edit an existing task by ID
+ *
+ * PASTE-TO-CONSOLE:
+ *   Replace ARGS_PLACEHOLDER with: { id: "your-task-id", flagged: true }
+ *   Example: const args = { id: "jMBMptE7rJ1", name: "Updated name", flagged: true };
+ */
+(() => {
+  const args = __ARGS__;
+
+  function NotFoundError(msg) { var e = new Error(msg); e.name = "NotFoundError"; return e; }
+
+  function isoOrNull(d) { return d ? d.toISOString() : null; }
+
+  function taskStatus(task) {
+    try {
+      const s = task.taskStatus;
+      if (s === Task.Status.Available) return "available";
+      if (s === Task.Status.Blocked) return "blocked";
+      if (s === Task.Status.Completed) return "complete";
+      if (s === Task.Status.Dropped) return "dropped";
+      if (s === Task.Status.DueSoon) return "dueSoon";
+      if (s === Task.Status.Next) return "next";
+      if (s === Task.Status.Overdue) return "overdue";
+      return "incomplete";
+    } catch(_) { return "incomplete"; }
+  }
+
+  var DAY_ABBR = {
+    sunday: "SU", monday: "MO", tuesday: "TU", wednesday: "WE",
+    thursday: "TH", friday: "FR", saturday: "SA"
+  };
+
+  var FREQ_MAP = { daily: "DAILY", weekly: "WEEKLY", monthly: "MONTHLY", yearly: "YEARLY" };
+
+  function buildRrule(rule) {
+    var rrule = "FREQ=" + FREQ_MAP[rule.frequency] + ";INTERVAL=" + (rule.interval || 1);
+    if (rule.daysOfWeek && rule.daysOfWeek.length > 0) {
+      rrule += ";BYDAY=" + rule.daysOfWeek.map(function(d) { return DAY_ABBR[d]; }).join(",");
+    }
+    return rrule;
+  }
+
+  function buildMethod(methodStr) {
+    var m = Task.RepetitionMethod;
+    if (methodStr === "dueDate") return m.DueDate;
+    if (methodStr === "start") return m.DeferUntilDate;
+    return m.Fixed;
+  }
+
+  function parseMethod(method) {
+    var s = String(method);
+    if (s.indexOf("DueDate") >= 0) return "dueDate";
+    if (s.indexOf("DeferUntilDate") >= 0) return "start";
+    return "fixed";
+  }
+
+  function parseRepetitionRule(rule) {
+    if (!rule) return null;
+    try {
+      var ruleStr = rule.ruleString || "";
+      var parts = {};
+      ruleStr.split(";").forEach(function(part) {
+        var kv = part.split("=");
+        if (kv.length === 2) parts[kv[0]] = kv[1];
+      });
+      var freqMap = { DAILY: "daily", WEEKLY: "weekly", MONTHLY: "monthly", YEARLY: "yearly" };
+      var frequency = freqMap[parts["FREQ"]] || "daily";
+      var interval = parts["INTERVAL"] ? parseInt(parts["INTERVAL"], 10) : 1;
+      var ABBR_DAY = { SU: "sunday", MO: "monday", TU: "tuesday", WE: "wednesday", TH: "thursday", FR: "friday", SA: "saturday" };
+      var daysOfWeek = parts["BYDAY"] ? parts["BYDAY"].split(",").map(function(a) { return ABBR_DAY[a]; }).filter(Boolean) : undefined;
+      var result = { frequency: frequency, interval: interval, method: parseMethod(rule.method) };
+      if (daysOfWeek && daysOfWeek.length > 0) result.daysOfWeek = daysOfWeek;
+      return result;
+    } catch(_) { return null; }
+  }
+
+  function taskDetail(task) {
+    var containerId = null;
+    var containerType = null;
+    if (task.parentTask) {
+      containerId = task.parentTask.id.primaryKey;
+      containerType = "task";
+    } else if (task.containingProject) {
+      containerId = task.containingProject.id.primaryKey;
+      containerType = "project";
+    }
+    return {
+      id: task.id.primaryKey,
+      name: task.name,
+      note: task.note || "",
+      status: taskStatus(task),
+      flagged: task.flagged || false,
+      deferDate: isoOrNull(task.deferDate),
+      plannedDate: isoOrNull(task.plannedDate),
+      dueDate: isoOrNull(task.dueDate),
+      completionDate: isoOrNull(task.completionDate),
+      estimatedMinutes: task.estimatedMinutes || null,
+      containerId: containerId,
+      containerType: containerType,
+      tagIds: (task.tags || []).map(function(t) { return t.id.primaryKey; }),
+      parentTaskId: task.parentTask ? task.parentTask.id.primaryKey : null,
+      repetitionRule: parseRepetitionRule(task.repetitionRule),
+    };
+  }
+
+  var task = flattenedTasks.find(function(t) { return t.id.primaryKey === args.id; });
+  if (!task) throw new NotFoundError("Task not found: " + args.id);
+
+  if (args.name !== undefined) task.name = args.name;
+  if (args.note !== undefined) task.note = args.note;
+  if (args.flagged !== undefined) task.flagged = args.flagged;
+
+  if ("deferDate" in args) {
+    task.deferDate = args.deferDate ? new Date(args.deferDate) : null;
+  }
+  if ("plannedDate" in args) {
+    task.plannedDate = args.plannedDate ? new Date(args.plannedDate) : null;
+  }
+  if ("dueDate" in args) {
+    task.dueDate = args.dueDate ? new Date(args.dueDate) : null;
+  }
+  if ("estimatedMinutes" in args) {
+    task.estimatedMinutes = args.estimatedMinutes;
+  }
+
+  if (args.tagIds !== undefined) {
+    // Replace full tag set: remove all existing, add new ones
+    (task.tags || []).slice().forEach(function(t) { task.removeTag(t); });
+    args.tagIds.forEach(function(tagId) {
+      var tag = flattenedTags.find(function(t) { return t.id.primaryKey === tagId; });
+      if (!tag) throw new NotFoundError("Tag not found: " + tagId);
+      task.addTag(tag);
+    });
+  }
+
+  if ("repetitionRule" in args) {
+    if (args.repetitionRule === null) {
+      task.repetitionRule = null;
+    } else if (args.repetitionRule) {
+      task.repetitionRule = new Task.RepetitionRule(buildRrule(args.repetitionRule), buildMethod(args.repetitionRule.method));
+    }
+  }
+
+  return JSON.stringify({ ok: true, data: taskDetail(task) });
+})();

package/src/snippets/get_folder.js

@@ -0,0 +1,48 @@
+/**
+ * get_folder.js — Get full folder detail by ID
+ *
+ * PASTE-TO-CONSOLE:
+ *   Replace ARGS_PLACEHOLDER with: { id: "your-folder-id" }
+ *   Example: const args = { id: "jMBMptE7rJ1" };
+ */
+(() => {
+  const args = __ARGS__;
+
+  function NotFoundError(msg) { var e = new Error(msg); e.name = "NotFoundError"; return e; }
+
+  function buildPath(folder) {
+    const parts = [];
+    let current = folder;
+    while (current) {
+      parts.unshift(current.name);
+      current = current.parent;
+    }
+    return parts.join(" \u25b8 ");
+  }
+
+  function folderStatus(folder) {
+    try {
+      return folder.active === false ? "dropped" : "active";
+    } catch(_) { return "active"; }
+  }
+
+  const folder = flattenedFolders.find(function(f) {
+    return f.id.primaryKey === args.id;
+  });
+
+  if (!folder) {
+    throw new NotFoundError("Folder not found: " + args.id);
+  }
+
+  const detail = {
+    id: folder.id.primaryKey,
+    name: folder.name,
+    path: buildPath(folder),
+    parentId: folder.parent ? folder.parent.id.primaryKey : null,
+    status: folderStatus(folder),
+    childFolderIds: (folder.folders || []).map(function(f) { return f.id.primaryKey; }),
+    projectIds: (folder.projects || []).map(function(p) { return p.id.primaryKey; }),
+  };
+
+  return JSON.stringify({ ok: true, data: detail });
+})();

package/src/snippets/get_project.js

@@ -0,0 +1,77 @@
+/**
+ * get_project.js — Get full project detail by ID
+ *
+ * PASTE-TO-CONSOLE:
+ *   Replace ARGS_PLACEHOLDER with: { id: "your-project-id" }
+ *   Example: const args = { id: "jMBMptE7rJ1" };
+ */
+(() => {
+  const args = __ARGS__;
+
+  function NotFoundError(msg) { var e = new Error(msg); e.name = "NotFoundError"; return e; }
+
+  function folderPath(project) {
+    const parts = [];
+    let container = project.parentFolder;
+    while (container) {
+      parts.unshift(container.name);
+      container = container.parent;
+    }
+    return parts.join(" \u25b8 ");
+  }
+
+  function projectType(project) {
+    if (project.containsSingletonActions) return "singleActions";
+    if (project.sequential) return "sequential";
+    return "parallel";
+  }
+
+  function projectStatus(project) {
+    const s = project.status;
+    if (s === Project.Status.Active) return "active";
+    if (s === Project.Status.OnHold) return "onHold";
+    if (s === Project.Status.Done) return "done";
+    if (s === Project.Status.Dropped) return "dropped";
+    return "active";
+  }
+
+  function isoOrNull(d) {
+    return d ? d.toISOString() : null;
+  }
+
+  function reviewIntervalString(p) {
+    try {
+      const ri = p.reviewInterval;
+      if (!ri) return null;
+      // ReviewInterval has .steps (number) and .unit (enum: days/weeks/months/years)
+      return ri.steps + ' ' + ri.unit;
+    } catch(_) { return null; }
+  }
+
+  const project = flattenedProjects.find(function(p) {
+    return p.id.primaryKey === args.id;
+  });
+
+  if (!project) {
+    throw new NotFoundError("Project not found: " + args.id);
+  }
+
+  const detail = {
+    id: project.id.primaryKey,
+    name: project.name,
+    note: project.note || "",
+    folderPath: folderPath(project),
+    status: projectStatus(project),
+    type: projectType(project),
+    flagged: project.flagged || false,
+    deferDate: isoOrNull(project.deferDate),
+    dueDate: isoOrNull(project.dueDate),
+    completionDate: isoOrNull(project.completionDate),
+    reviewInterval: reviewIntervalString(project),
+    nextReviewDate: isoOrNull(project.nextReviewDate),
+    lastReviewDate: isoOrNull(project.lastReviewDate),
+    tagIds: (project.tags || []).map(function(t) { return t.id.primaryKey; }),
+  };
+
+  return JSON.stringify({ ok: true, data: detail });
+})();

package/src/snippets/get_tag.js

@@ -0,0 +1,51 @@
+/**
+ * get_tag.js — Get full tag detail by ID
+ *
+ * PASTE-TO-CONSOLE:
+ *   Replace ARGS_PLACEHOLDER with: { id: "your-tag-id" }
+ *   Example: const args = { id: "jMBMptE7rJ1" };
+ */
+(() => {
+  const args = __ARGS__;
+
+  function NotFoundError(msg) { var e = new Error(msg); e.name = "NotFoundError"; return e; }
+
+  function buildPath(tag) {
+    const parts = [];
+    let current = tag;
+    while (current) {
+      parts.unshift(current.name);
+      current = current.parent;
+    }
+    return parts.join(" \u25b8 ");
+  }
+
+  function tagStatus(tag) {
+    try {
+      const s = tag.status;
+      if (s === Tag.Status.Active) return "active";
+      if (s === Tag.Status.OnHold) return "onHold";
+      if (s === Tag.Status.Dropped) return "dropped";
+      return "active";
+    } catch(_) { return "active"; }
+  }
+
+  const tag = flattenedTags.find(function(t) {
+    return t.id.primaryKey === args.id;
+  });
+
+  if (!tag) {
+    throw new NotFoundError("Tag not found: " + args.id);
+  }
+
+  const detail = {
+    id: tag.id.primaryKey,
+    name: tag.name,
+    path: buildPath(tag),
+    parentId: tag.parent ? tag.parent.id.primaryKey : null,
+    status: tagStatus(tag),
+    childTagIds: (tag.children || []).map(function(c) { return c.id.primaryKey; }),
+  };
+
+  return JSON.stringify({ ok: true, data: detail });
+})();

package/src/snippets/get_task.js

@@ -0,0 +1,96 @@
+/**
+ * get_task.js — Get full task detail by ID
+ *
+ * PASTE-TO-CONSOLE:
+ *   Replace ARGS_PLACEHOLDER with: { id: "your-task-id" }
+ *   Example: const args = { id: "jMBMptE7rJ1" };
+ */
+(() => {
+  const args = __ARGS__;
+
+  function NotFoundError(msg) { var e = new Error(msg); e.name = "NotFoundError"; return e; }
+
+  function isoOrNull(d) {
+    return d ? d.toISOString() : null;
+  }
+
+  function taskStatus(task) {
+    try {
+      const s = task.taskStatus;
+      if (s === Task.Status.Available) return "available";
+      if (s === Task.Status.Blocked) return "blocked";
+      if (s === Task.Status.Completed) return "complete";
+      if (s === Task.Status.Dropped) return "dropped";
+      if (s === Task.Status.DueSoon) return "dueSoon";
+      if (s === Task.Status.Next) return "next";
+      if (s === Task.Status.Overdue) return "overdue";
+      return "incomplete";
+    } catch(_) { return "incomplete"; }
+  }
+
+  function containerInfo(task) {
+    if (!task.assignedContainer) return { containerId: null, containerType: null };
+    const c = task.assignedContainer;
+    if (c instanceof Project) {
+      return { containerId: c.id.primaryKey, containerType: "project" };
+    }
+    return { containerId: c.id.primaryKey, containerType: "task" };
+  }
+
+  function parseMethod(method) {
+    var s = String(method);
+    if (s.indexOf("DueDate") >= 0) return "dueDate";
+    if (s.indexOf("DeferUntilDate") >= 0) return "start";
+    return "fixed";
+  }
+
+  function parseRepetitionRule(rule) {
+    if (!rule) return null;
+    try {
+      var ruleStr = rule.ruleString || "";
+      var parts = {};
+      ruleStr.split(";").forEach(function(part) {
+        var kv = part.split("=");
+        if (kv.length === 2) parts[kv[0]] = kv[1];
+      });
+      var freqMap = { DAILY: "daily", WEEKLY: "weekly", MONTHLY: "monthly", YEARLY: "yearly" };
+      var frequency = freqMap[parts["FREQ"]] || "daily";
+      var interval = parts["INTERVAL"] ? parseInt(parts["INTERVAL"], 10) : 1;
+      var ABBR_DAY = { SU: "sunday", MO: "monday", TU: "tuesday", WE: "wednesday", TH: "thursday", FR: "friday", SA: "saturday" };
+      var daysOfWeek = parts["BYDAY"] ? parts["BYDAY"].split(",").map(function(a) { return ABBR_DAY[a]; }).filter(Boolean) : undefined;
+      var result = { frequency: frequency, interval: interval, method: parseMethod(rule.method) };
+      if (daysOfWeek && daysOfWeek.length > 0) result.daysOfWeek = daysOfWeek;
+      return result;
+    } catch(_) { return null; }
+  }
+
+  const task = flattenedTasks.find(function(t) {
+    return t.id.primaryKey === args.id;
+  });
+
+  if (!task) {
+    throw new NotFoundError("Task not found: " + args.id);
+  }
+
+  const ci = containerInfo(task);
+
+  const detail = {
+    id: task.id.primaryKey,
+    name: task.name,
+    note: task.note || "",
+    status: taskStatus(task),
+    flagged: task.flagged || false,
+    deferDate: isoOrNull(task.deferDate),
+    plannedDate: isoOrNull(task.plannedDate),
+    dueDate: isoOrNull(task.dueDate),
+    completionDate: isoOrNull(task.completionDate),
+    estimatedMinutes: task.estimatedMinutes || null,
+    containerId: ci.containerId,
+    containerType: ci.containerType,
+    tagIds: (task.tags || []).map(function(t) { return t.id.primaryKey; }),
+    parentTaskId: task.parentTask ? task.parentTask.id.primaryKey : null,
+    repetitionRule: parseRepetitionRule(task.repetitionRule),
+  };
+
+  return JSON.stringify({ ok: true, data: detail });
+})();

package/src/snippets/list_folders.js

@@ -0,0 +1,50 @@
+/**
+ * list_folders.js — List all folders in OmniFocus with optional filtering
+ *
+ * PASTE-TO-CONSOLE:
+ *   Replace ARGS_PLACEHOLDER with one of:
+ *     {}
+ *     { filter: { status: "active" } }
+ *     { limit: 50 }
+ *   Example: const args = { filter: { status: "active" }, limit: 100 };
+ */
+(() => {
+  const args = __ARGS__;
+
+  function buildPath(folder) {
+    const parts = [];
+    let current = folder;
+    while (current) {
+      parts.unshift(current.name);
+      current = current.parent;
+    }
+    return parts.join(" \u25b8 ");
+  }
+
+  function folderStatus(folder) {
+    try {
+      return folder.active === false ? "dropped" : "active";
+    } catch(_) { return "active"; }
+  }
+
+  const limit = (args.limit !== undefined && args.limit !== null) ? args.limit : 200;
+  const statusFilter = args.filter && args.filter.status ? args.filter.status : null;
+
+  var folders = [];
+  var all = flattenedFolders;
+  for (var i = 0; i < all.length; i++) {
+    var f = all[i];
+    var status = folderStatus(f);
+    if (statusFilter && status !== statusFilter) continue;
+    folders.push({
+      id: f.id.primaryKey,
+      name: f.name,
+      path: buildPath(f),
+      parentId: f.parent ? f.parent.id.primaryKey : null,
+      status: status,
+    });
+    if (folders.length >= limit) break;
+  }
+
+  return JSON.stringify({ ok: true, data: folders });
+})();

package/src/snippets/list_projects.js

@@ -0,0 +1,98 @@
+/**
+ * list_projects.js — List projects in OmniFocus with optional filtering
+ *
+ * PASTE-TO-CONSOLE:
+ *   Replace ARGS_PLACEHOLDER with one of:
+ *     {}
+ *     { filter: { status: ["active"] } }
+ *     { filter: { folderId: "abc123" } }
+ *     { filter: { flagged: true } }
+ *     { limit: 50 }
+ *   Example: const args = {};
+ */
+(() => {
+  const args = __ARGS__;
+
+  function NotFoundError(msg) { var e = new Error(msg); e.name = "NotFoundError"; return e; }
+
+  function folderPath(project) {
+    var parts = [];
+    var container = project.parentFolder;
+    while (container) {
+      parts.unshift(container.name);
+      container = container.parent;
+    }
+    return parts.join(" \u25b8 ");
+  }
+
+  function projectType(project) {
+    if (project.containsSingletonActions) return "singleActions";
+    if (project.sequential) return "sequential";
+    return "parallel";
+  }
+
+  function projectStatusString(project) {
+    var s = project.status;
+    if (s === Project.Status.Active) return "active";
+    if (s === Project.Status.OnHold) return "onHold";
+    if (s === Project.Status.Done) return "done";
+    if (s === Project.Status.Dropped) return "dropped";
+    return "active";
+  }
+
+  function mapProject(p) {
+    return {
+      id: p.id.primaryKey,
+      name: p.name,
+      folderPath: folderPath(p),
+      folderId: p.parentFolder ? p.parentFolder.id.primaryKey : null,
+      status: projectStatusString(p),
+      type: projectType(p),
+      flagged: p.flagged || false,
+    };
+  }
+
+  // ── Scope: start from folder subtree or all projects ───────────────────────
+
+  var filter = args.filter || {};
+  var projects;
+
+  if (filter.folderId) {
+    var folder = flattenedFolders.find(function(f) {
+      return f.id.primaryKey === filter.folderId;
+    });
+    if (!folder) throw new NotFoundError("Folder not found: " + filter.folderId);
+    projects = folder.flattenedProjects.map(mapProject);
+  } else {
+    projects = flattenedProjects.map(mapProject);
+  }
+
+  // ── Status filter ───────────────────────────────────────────────────────────
+
+  var hasStatusFilter = Array.isArray(filter.status) && filter.status.length > 0;
+
+  if (!hasStatusFilter) {
+    projects = projects.filter(function(p) {
+      return p.status !== "done" && p.status !== "dropped";
+    });
+  } else {
+    projects = projects.filter(function(p) {
+      return filter.status.indexOf(p.status) !== -1;
+    });
+  }
+
+  // ── Flagged filter ──────────────────────────────────────────────────────────
+
+  if (filter.flagged === true) {
+    projects = projects.filter(function(p) { return p.flagged === true; });
+  }
+
+  // ── Limit ───────────────────────────────────────────────────────────────────
+
+  var limit = (args.limit !== undefined && args.limit !== null) ? args.limit : 100;
+  if (projects.length > limit) {
+    projects = projects.slice(0, limit);
+  }
+
+  return JSON.stringify({ ok: true, data: projects });
+})();

package/src/snippets/list_tags.js

@@ -0,0 +1,54 @@
+/**
+ * list_tags.js — List all tags in OmniFocus with optional filtering
+ *
+ * PASTE-TO-CONSOLE:
+ *   Replace ARGS_PLACEHOLDER with one of:
+ *     {}
+ *     { filter: { status: "active" } }
+ *     { limit: 50 }
+ *   Example: const args = { filter: { status: "active" }, limit: 100 };
+ */
+(() => {
+  const args = __ARGS__;
+
+  function buildPath(tag) {
+    const parts = [];
+    let current = tag;
+    while (current) {
+      parts.unshift(current.name);
+      current = current.parent;
+    }
+    return parts.join(" \u25b8 ");
+  }
+
+  function tagStatus(tag) {
+    try {
+      const s = tag.status;
+      if (s === Tag.Status.Active) return "active";
+      if (s === Tag.Status.OnHold) return "onHold";
+      if (s === Tag.Status.Dropped) return "dropped";
+      return "active";
+    } catch(_) { return "active"; }
+  }
+
+  const limit = (args.limit !== undefined && args.limit !== null) ? args.limit : 200;
+  const statusFilter = args.filter && args.filter.status ? args.filter.status : null;
+
+  var tags = [];
+  var all = flattenedTags;
+  for (var i = 0; i < all.length; i++) {
+    var t = all[i];
+    var status = tagStatus(t);
+    if (statusFilter && status !== statusFilter) continue;
+    tags.push({
+      id: t.id.primaryKey,
+      name: t.name,
+      path: buildPath(t),
+      parentId: t.parent ? t.parent.id.primaryKey : null,
+      status: status,
+    });
+    if (tags.length >= limit) break;
+  }
+
+  return JSON.stringify({ ok: true, data: tags });
+})();