@stephendolan/omnifocus-cli 2.1.0 → 2.3.0

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 
 // src/cli.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 
 // src/lib/output.ts
 var globalOutputOptions = {};
@@ -369,7 +369,7 @@ var OmniFocus = class {
       updates.push(`task.flagged = ${options.flagged};`);
     }
     if (options.completed !== void 0) {
-      updates.push(`task.completed = ${options.completed};`);
+      updates.push(options.completed ? "task.markComplete();" : "task.markIncomplete();");
     }
     if (options.estimatedMinutes !== void 0) {
       updates.push(`task.estimatedMinutes = ${options.estimatedMinutes};`);
@@ -997,21 +997,21 @@ function createTaskCommand() {
   command.description("Manage OmniFocus tasks");
   command.command("list").alias("ls").description("List tasks").option("-f, --flagged", "Show only flagged tasks").option("-p, --project <name>", "Filter by project").option("-t, --tag <name>", "Filter by tag").option("-c, --completed", "Include completed tasks").action(
     withErrorHandling(async (options) => {
-      const of = new OmniFocus();
+      const of2 = new OmniFocus();
       const filters = {
         includeCompleted: options.completed,
         ...options.flagged && { flagged: true },
         ...options.project && { project: options.project },
         ...options.tag && { tag: options.tag }
       };
-      const tasks = await of.listTasks(filters);
+      const tasks = await of2.listTasks(filters);
       outputJson(tasks);
     })
   );
   command.command("create <name>").description("Create a new task").option("-p, --project <name>", "Assign to project").option("--note <text>", "Add note").option("-t, --tag <tags...>", "Add tags").option("-d, --due <date>", "Set due date").option("-D, --defer <date>", "Set defer date").option("-f, --flagged", "Flag the task").option("-e, --estimate <minutes>", "Estimated time in minutes", parseInt).action(
     withErrorHandling(async (name, options) => {
-      const of = new OmniFocus();
-      const task = await of.createTask({
+      const of2 = new OmniFocus();
+      const task = await of2.createTask({
         name,
         note: options.note,
         project: options.project,
@@ -1026,7 +1026,7 @@ function createTaskCommand() {
   );
   command.command("update <idOrName>").description("Update an existing task").option("-n, --name <name>", "New name").option("--note <text>", "New note").option("-p, --project <name>", "Move to project").option("-t, --tag <tags...>", "Replace tags").option("-d, --due <date>", "Set due date").option("-D, --defer <date>", "Set defer date").option("-f, --flag", "Flag the task").option("-F, --unflag", "Unflag the task").option("-c, --complete", "Mark as completed").option("-C, --incomplete", "Mark as incomplete").option("-e, --estimate <minutes>", "Estimated time in minutes", parseInt).action(
     withErrorHandling(async (idOrName, options) => {
-      const of = new OmniFocus();
+      const of2 = new OmniFocus();
       const updates = {
         ...options.name && { name: options.name },
         ...options.note !== void 0 && { note: options.note },
@@ -1044,28 +1044,28 @@ function createTaskCommand() {
         ...options.incomplete && { completed: false },
         ...options.estimate !== void 0 && { estimatedMinutes: options.estimate }
       };
-      const task = await of.updateTask(idOrName, updates);
+      const task = await of2.updateTask(idOrName, updates);
       outputJson(task);
     })
   );
   command.command("delete <idOrName>").alias("rm").description("Delete a task").action(
     withErrorHandling(async (idOrName) => {
-      const of = new OmniFocus();
-      await of.deleteTask(idOrName);
+      const of2 = new OmniFocus();
+      await of2.deleteTask(idOrName);
       outputJson({ message: "Task deleted successfully" });
     })
   );
   command.command("view <idOrName>").description("View task details").action(
     withErrorHandling(async (idOrName) => {
-      const of = new OmniFocus();
-      const task = await of.getTask(idOrName);
+      const of2 = new OmniFocus();
+      const task = await of2.getTask(idOrName);
       outputJson(task);
     })
   );
   command.command("stats").description("Show task statistics").action(
     withErrorHandling(async () => {
-      const of = new OmniFocus();
-      const stats = await of.getTaskStats();
+      const of2 = new OmniFocus();
+      const stats = await of2.getTaskStats();
       outputJson(stats);
     })
   );
@@ -1079,20 +1079,20 @@ function createProjectCommand() {
   command.description("Manage OmniFocus projects");
   command.command("list").alias("ls").description("List projects").option("-f, --folder <name>", "Filter by folder").option("-s, --status <status>", "Filter by status (active, on hold, dropped)").option("-d, --dropped", "Include dropped projects").action(
     withErrorHandling(async (options) => {
-      const of = new OmniFocus();
+      const of2 = new OmniFocus();
       const filters = {
         includeDropped: options.dropped,
         ...options.folder && { folder: options.folder },
         ...options.status && { status: options.status }
       };
-      const projects = await of.listProjects(filters);
+      const projects = await of2.listProjects(filters);
       outputJson(projects);
     })
   );
   command.command("create <name>").description("Create a new project").option("-f, --folder <name>", "Assign to folder").option("--note <text>", "Add note").option("-t, --tag <tags...>", "Add tags").option("-s, --sequential", "Make it a sequential project").option("--status <status>", "Set status (active, on hold, dropped)").action(
     withErrorHandling(async (name, options) => {
-      const of = new OmniFocus();
-      const project = await of.createProject({
+      const of2 = new OmniFocus();
+      const project = await of2.createProject({
         name,
         note: options.note,
         folder: options.folder,
@@ -1105,7 +1105,7 @@ function createProjectCommand() {
   );
   command.command("update <idOrName>").description("Update an existing project").option("-n, --name <name>", "Rename project").option("--note <text>", "New note").option("-f, --folder <name>", "Move to folder").option("-t, --tag <tags...>", "Replace tags").option("-s, --sequential", "Make it sequential").option("-p, --parallel", "Make it parallel").option("--status <status>", "Set status (active, on hold, dropped)").action(
     withErrorHandling(async (idOrName, options) => {
-      const of = new OmniFocus();
+      const of2 = new OmniFocus();
       const updates = {
         ...options.name && { name: options.name },
         ...options.note !== void 0 && { note: options.note },
@@ -1115,28 +1115,28 @@ function createProjectCommand() {
         ...options.parallel && { sequential: false },
         ...options.status && { status: options.status }
       };
-      const project = await of.updateProject(idOrName, updates);
+      const project = await of2.updateProject(idOrName, updates);
       outputJson(project);
     })
   );
   command.command("delete <idOrName>").alias("rm").description("Delete a project").action(
     withErrorHandling(async (idOrName) => {
-      const of = new OmniFocus();
-      await of.deleteProject(idOrName);
+      const of2 = new OmniFocus();
+      await of2.deleteProject(idOrName);
       outputJson({ message: "Project deleted successfully" });
     })
   );
   command.command("view <idOrName>").description("View project details").action(
     withErrorHandling(async (idOrName) => {
-      const of = new OmniFocus();
-      const project = await of.getProject(idOrName);
+      const of2 = new OmniFocus();
+      const project = await of2.getProject(idOrName);
       outputJson(project);
     })
   );
   command.command("stats").description("Show project statistics").action(
     withErrorHandling(async () => {
-      const of = new OmniFocus();
-      const stats = await of.getProjectStats();
+      const of2 = new OmniFocus();
+      const stats = await of2.getProjectStats();
       outputJson(stats);
     })
   );
@@ -1150,18 +1150,33 @@ function createInboxCommand() {
   command.description("Manage OmniFocus inbox");
   command.command("list").alias("ls").description("List inbox tasks").action(
     withErrorHandling(async () => {
-      const of = new OmniFocus();
-      const tasks = await of.listInboxTasks();
+      const of2 = new OmniFocus();
+      const tasks = await of2.listInboxTasks();
       outputJson(tasks);
     })
   );
   command.command("count").description("Get inbox count").action(
     withErrorHandling(async () => {
-      const of = new OmniFocus();
-      const count = await of.getInboxCount();
+      const of2 = new OmniFocus();
+      const count = await of2.getInboxCount();
       outputJson({ count });
     })
   );
+  command.command("add <name>").description("Add a task to inbox").option("--note <text>", "Add note").option("-t, --tag <tags...>", "Add tags").option("-d, --due <date>", "Set due date").option("-D, --defer <date>", "Set defer date").option("-f, --flagged", "Flag the task").option("-e, --estimate <minutes>", "Estimated time in minutes", parseInt).action(
+    withErrorHandling(async (name, options) => {
+      const of2 = new OmniFocus();
+      const task = await of2.createTask({
+        name,
+        note: options.note,
+        tags: options.tag,
+        due: options.due ? parseDateTime(options.due) : void 0,
+        defer: options.defer ? parseDateTime(options.defer) : void 0,
+        flagged: options.flagged,
+        estimatedMinutes: options.estimate
+      });
+      outputJson(task);
+    })
+  );
   return command;
 }
 
@@ -1173,8 +1188,8 @@ function createSearchCommand() {
   command.argument("<query>", "Search query");
   command.action(
     withErrorHandling(async (query) => {
-      const of = new OmniFocus();
-      const tasks = await of.searchTasks(query);
+      const of2 = new OmniFocus();
+      const tasks = await of2.searchTasks(query);
       outputJson(tasks);
     })
   );
@@ -1188,15 +1203,15 @@ function createPerspectiveCommand() {
   command.description("Manage OmniFocus perspectives");
   command.command("list").alias("ls").description("List all perspectives").action(
     withErrorHandling(async () => {
-      const of = new OmniFocus();
-      const perspectives = await of.listPerspectives();
+      const of2 = new OmniFocus();
+      const perspectives = await of2.listPerspectives();
       outputJson(perspectives);
     })
   );
   command.command("view <name>").description("View tasks in a perspective").action(
     withErrorHandling(async (name) => {
-      const of = new OmniFocus();
-      const tasks = await of.getPerspectiveTasks(name);
+      const of2 = new OmniFocus();
+      const tasks = await of2.getPerspectiveTasks(name);
       outputJson(tasks);
     })
   );
@@ -1210,8 +1225,8 @@ function createTagCommand() {
   command.description("Manage and analyze OmniFocus tags");
   command.command("list").alias("ls").description("List tags with usage information").option("-u, --unused-days <days>", "Show tags unused for N days", parseInt).option("-s, --sort <field>", "Sort by: name, usage, activity (default: name)", "name").option("-a, --active-only", "Only count active (incomplete) tasks").action(
     withErrorHandling(async (options) => {
-      const of = new OmniFocus();
-      const tags = await of.listTags({
+      const of2 = new OmniFocus();
+      const tags = await of2.listTags({
         unusedDays: options.unusedDays,
         sortBy: options.sort,
         activeOnly: options.activeOnly
@@ -1221,8 +1236,8 @@ function createTagCommand() {
   );
   command.command("create <name>").description("Create a new tag").option("-p, --parent <name>", "Create as child of parent tag").option("-s, --status <status>", "Set status (active, on hold, dropped)").action(
     withErrorHandling(async (name, options) => {
-      const of = new OmniFocus();
-      const tag = await of.createTag({
+      const of2 = new OmniFocus();
+      const tag = await of2.createTag({
         name,
         parent: options.parent,
         status: options.status
@@ -1232,33 +1247,33 @@ function createTagCommand() {
   );
   command.command("view <idOrName>").description("View tag details").action(
     withErrorHandling(async (idOrName) => {
-      const of = new OmniFocus();
-      const tag = await of.getTag(idOrName);
+      const of2 = new OmniFocus();
+      const tag = await of2.getTag(idOrName);
       outputJson(tag);
     })
   );
   command.command("update <idOrName>").description("Update an existing tag").option("-n, --name <name>", "Rename tag").option("-s, --status <status>", "Set status (active, on hold, dropped)").action(
     withErrorHandling(async (idOrName, options) => {
-      const of = new OmniFocus();
+      const of2 = new OmniFocus();
       const updates = {
         ...options.name && { name: options.name },
         ...options.status && { status: options.status }
       };
-      const tag = await of.updateTag(idOrName, updates);
+      const tag = await of2.updateTag(idOrName, updates);
       outputJson(tag);
     })
   );
   command.command("delete <idOrName>").alias("rm").description("Delete a tag").action(
     withErrorHandling(async (idOrName) => {
-      const of = new OmniFocus();
-      await of.deleteTag(idOrName);
+      const of2 = new OmniFocus();
+      await of2.deleteTag(idOrName);
       outputJson({ message: "Tag deleted successfully" });
     })
   );
   command.command("stats").description("Show tag usage statistics").action(
     withErrorHandling(async () => {
-      const of = new OmniFocus();
-      const stats = await of.getTagStats();
+      const of2 = new OmniFocus();
+      const stats = await of2.getTagStats();
       outputJson(stats);
     })
   );
@@ -1272,25 +1287,273 @@ function createFolderCommand() {
   command.description("View OmniFocus folder hierarchy");
   command.command("list").alias("ls").description("List top-level folders with nested children").option("-d, --dropped", "Include dropped folders").action(
     withErrorHandling(async (options) => {
-      const of = new OmniFocus();
-      const folders = await of.listFolders({ includeDropped: options.dropped });
+      const of2 = new OmniFocus();
+      const folders = await of2.listFolders({ includeDropped: options.dropped });
       outputJson(folders);
     })
   );
   command.command("view <idOrName>").description("View folder details and children").option("-d, --dropped", "Include dropped child folders").action(
     withErrorHandling(async (idOrName, options) => {
-      const of = new OmniFocus();
+      const of2 = new OmniFocus();
       const filters = { includeDropped: options.dropped };
-      const folder = await of.getFolder(idOrName, filters);
+      const folder = await of2.getFolder(idOrName, filters);
       outputJson(folder);
     })
   );
   return command;
 }
 
+// src/commands/mcp.ts
+import { Command as Command8 } from "commander";
+
+// src/mcp/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+var server = new McpServer({
+  name: "omnifocus",
+  version: "1.0.0"
+});
+var of = new OmniFocus();
+function jsonResponse(data) {
+  return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+server.tool(
+  "list_tasks",
+  "List tasks with optional filtering",
+  {
+    includeCompleted: z.boolean().optional().describe("Include completed tasks"),
+    includeDropped: z.boolean().optional().describe("Include dropped tasks"),
+    flagged: z.boolean().optional().describe("Only show flagged tasks"),
+    project: z.string().optional().describe("Filter by project name"),
+    tag: z.string().optional().describe("Filter by tag name")
+  },
+  async (filters) => jsonResponse(await of.listTasks(filters))
+);
+server.tool(
+  "get_task",
+  "Get a specific task by ID or name",
+  { idOrName: z.string().describe("Task ID or name") },
+  async ({ idOrName }) => jsonResponse(await of.getTask(idOrName))
+);
+server.tool(
+  "create_task",
+  "Create a new task",
+  {
+    name: z.string().describe("Task name"),
+    note: z.string().optional().describe("Task note"),
+    project: z.string().optional().describe("Project to add task to"),
+    tags: z.array(z.string()).optional().describe("Tags to assign"),
+    defer: z.string().optional().describe("Defer date (ISO 8601)"),
+    due: z.string().optional().describe("Due date (ISO 8601)"),
+    flagged: z.boolean().optional().describe("Flag the task"),
+    estimatedMinutes: z.number().optional().describe("Estimated duration in minutes")
+  },
+  async (options) => jsonResponse(await of.createTask(options))
+);
+server.tool(
+  "update_task",
+  "Update an existing task",
+  {
+    idOrName: z.string().describe("Task ID or name"),
+    name: z.string().optional().describe("New task name"),
+    note: z.string().optional().describe("New task note"),
+    project: z.string().optional().describe("Move to project"),
+    tags: z.array(z.string()).optional().describe("Replace tags"),
+    defer: z.string().optional().describe("New defer date (ISO 8601)"),
+    due: z.string().optional().describe("New due date (ISO 8601)"),
+    flagged: z.boolean().optional().describe("Flag/unflag the task"),
+    estimatedMinutes: z.number().optional().describe("New estimated duration"),
+    completed: z.boolean().optional().describe("Mark complete/incomplete")
+  },
+  async ({ idOrName, ...options }) => jsonResponse(await of.updateTask(idOrName, options))
+);
+server.tool(
+  "delete_task",
+  "Delete a task",
+  { idOrName: z.string().describe("Task ID or name") },
+  async ({ idOrName }) => {
+    await of.deleteTask(idOrName);
+    return jsonResponse({ deleted: true });
+  }
+);
+server.tool(
+  "search_tasks",
+  "Search tasks by name or note content",
+  { query: z.string().describe("Search query") },
+  async ({ query }) => jsonResponse(await of.searchTasks(query))
+);
+server.tool(
+  "get_task_stats",
+  "Get task statistics",
+  {},
+  async () => jsonResponse(await of.getTaskStats())
+);
+server.tool(
+  "list_inbox",
+  "List all inbox tasks",
+  {},
+  async () => jsonResponse(await of.listInboxTasks())
+);
+server.tool(
+  "get_inbox_count",
+  "Get the number of inbox tasks",
+  {},
+  async () => jsonResponse({ count: await of.getInboxCount() })
+);
+server.tool(
+  "list_projects",
+  "List projects with optional filtering",
+  {
+    includeDropped: z.boolean().optional().describe("Include dropped projects"),
+    status: z.enum(["active", "on hold", "dropped"]).optional().describe("Filter by status"),
+    folder: z.string().optional().describe("Filter by folder name")
+  },
+  async (filters) => jsonResponse(await of.listProjects(filters))
+);
+server.tool(
+  "get_project",
+  "Get a specific project by ID or name",
+  { idOrName: z.string().describe("Project ID or name") },
+  async ({ idOrName }) => jsonResponse(await of.getProject(idOrName))
+);
+server.tool(
+  "create_project",
+  "Create a new project",
+  {
+    name: z.string().describe("Project name"),
+    note: z.string().optional().describe("Project note"),
+    folder: z.string().optional().describe("Folder to create project in"),
+    sequential: z.boolean().optional().describe("Sequential project (tasks must be done in order)"),
+    tags: z.array(z.string()).optional().describe("Tags to assign"),
+    status: z.enum(["active", "on hold", "dropped"]).optional().describe("Initial status")
+  },
+  async (options) => jsonResponse(await of.createProject(options))
+);
+server.tool(
+  "update_project",
+  "Update an existing project",
+  {
+    idOrName: z.string().describe("Project ID or name"),
+    name: z.string().optional().describe("New project name"),
+    note: z.string().optional().describe("New project note"),
+    folder: z.string().optional().describe("Move to folder"),
+    sequential: z.boolean().optional().describe("Set sequential/parallel"),
+    tags: z.array(z.string()).optional().describe("Replace tags"),
+    status: z.enum(["active", "on hold", "dropped"]).optional().describe("New status")
+  },
+  async ({ idOrName, ...options }) => jsonResponse(await of.updateProject(idOrName, options))
+);
+server.tool(
+  "delete_project",
+  "Delete a project",
+  { idOrName: z.string().describe("Project ID or name") },
+  async ({ idOrName }) => {
+    await of.deleteProject(idOrName);
+    return jsonResponse({ deleted: true });
+  }
+);
+server.tool(
+  "get_project_stats",
+  "Get project statistics",
+  {},
+  async () => jsonResponse(await of.getProjectStats())
+);
+server.tool(
+  "list_perspectives",
+  "List all available perspectives",
+  {},
+  async () => jsonResponse(await of.listPerspectives())
+);
+server.tool(
+  "get_perspective_tasks",
+  "Get tasks from a specific perspective",
+  { name: z.string().describe("Perspective name (e.g., Inbox, Flagged, or custom perspective)") },
+  async ({ name }) => jsonResponse(await of.getPerspectiveTasks(name))
+);
+server.tool(
+  "list_tags",
+  "List all tags with optional filtering and sorting",
+  {
+    unusedDays: z.number().optional().describe("Only show tags unused for this many days"),
+    sortBy: z.enum(["name", "usage", "activity"]).optional().describe("Sort order"),
+    activeOnly: z.boolean().optional().describe("Only count active tasks")
+  },
+  async (options) => jsonResponse(await of.listTags(options))
+);
+server.tool(
+  "get_tag",
+  "Get a specific tag by ID or name",
+  { idOrName: z.string().describe('Tag ID, name, or path (e.g., "Parent/Child")') },
+  async ({ idOrName }) => jsonResponse(await of.getTag(idOrName))
+);
+server.tool(
+  "create_tag",
+  "Create a new tag",
+  {
+    name: z.string().describe("Tag name"),
+    parent: z.string().optional().describe("Parent tag name or path"),
+    status: z.enum(["active", "on hold", "dropped"]).optional().describe("Initial status")
+  },
+  async (options) => jsonResponse(await of.createTag(options))
+);
+server.tool(
+  "update_tag",
+  "Update an existing tag",
+  {
+    idOrName: z.string().describe("Tag ID, name, or path"),
+    name: z.string().optional().describe("New tag name"),
+    status: z.enum(["active", "on hold", "dropped"]).optional().describe("New status")
+  },
+  async ({ idOrName, ...options }) => jsonResponse(await of.updateTag(idOrName, options))
+);
+server.tool(
+  "delete_tag",
+  "Delete a tag",
+  { idOrName: z.string().describe("Tag ID, name, or path") },
+  async ({ idOrName }) => {
+    await of.deleteTag(idOrName);
+    return jsonResponse({ deleted: true });
+  }
+);
+server.tool(
+  "get_tag_stats",
+  "Get tag statistics",
+  {},
+  async () => jsonResponse(await of.getTagStats())
+);
+server.tool(
+  "list_folders",
+  "List all folders",
+  { includeDropped: z.boolean().optional().describe("Include dropped folders") },
+  async (filters) => jsonResponse(await of.listFolders(filters))
+);
+server.tool(
+  "get_folder",
+  "Get a specific folder by ID or name",
+  {
+    idOrName: z.string().describe("Folder ID or name"),
+    includeDropped: z.boolean().optional().describe("Include dropped children")
+  },
+  async ({ idOrName, includeDropped }) => jsonResponse(await of.getFolder(idOrName, { includeDropped }))
+);
+async function runMcpServer() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+// src/commands/mcp.ts
+function createMcpCommand() {
+  const cmd = new Command8("mcp").description("Run OmniFocus MCP server");
+  cmd.action(async () => {
+    await runMcpServer();
+  });
+  return cmd;
+}
+
 // src/cli.ts
-var program = new Command8();
-program.name("of").description("A command-line interface for OmniFocus on macOS").version("2.1.0").option("-c, --compact", "Minified JSON output (single line)").hook("preAction", (thisCommand) => {
+var program = new Command9();
+program.name("of").description("A command-line interface for OmniFocus on macOS").version("2.3.0").option("-c, --compact", "Minified JSON output (single line)").hook("preAction", (thisCommand) => {
   const options = thisCommand.opts();
   setOutputOptions({
     compact: options.compact
@@ -1303,6 +1566,7 @@ program.addCommand(createSearchCommand());
 program.addCommand(createPerspectiveCommand());
 program.addCommand(createTagCommand());
 program.addCommand(createFolderCommand());
+program.addCommand(createMcpCommand());
 program.parseAsync().catch(() => {
   process.exit(1);
 });