omnifocus_mcp 1.0.0

data/lib/omnifocus_mcp/utils/omnifocus_scripts/omnifocusDump.js

@@ -0,0 +1,223 @@
+  // OmniJS script to export active tasks from OmniFocus database - Optimized
+  (() => {
+      try {
+        const startTime = new Date();
+
+        // Helper function to format dates consistently or return null
+        function formatDate(date) {
+          if (!date) return null;
+          return date.toISOString();
+        }
+
+        // Helper function to safely get enum values - Simplified with direct mapping
+        const taskStatusMap = {
+          [Task.Status.Available]: "Available",
+          [Task.Status.Blocked]: "Blocked",
+          [Task.Status.Completed]: "Completed",
+          [Task.Status.Dropped]: "Dropped",
+          [Task.Status.DueSoon]: "DueSoon",
+          [Task.Status.Next]: "Next",
+          [Task.Status.Overdue]: "Overdue"
+        };
+
+        const projectStatusMap = {
+          [Project.Status.Active]: "Active",
+          [Project.Status.Done]: "Done",
+          [Project.Status.Dropped]: "Dropped",
+          [Project.Status.OnHold]: "OnHold"
+        };
+
+        const folderStatusMap = {
+          [Folder.Status.Active]: "Active",
+          [Folder.Status.Dropped]: "Dropped"
+        };
+
+        function getEnumValue(enumObj, mapObj) {
+          if (enumObj === null || enumObj === undefined) return null;
+          return mapObj[enumObj] || "Unknown";
+        }
+
+        // Create database export object using Maps for faster lookups
+        const exportData = {
+          exportDate: new Date().toISOString(),
+          tasks: [],
+          projects: {},
+          folders: {},
+          tags: {}
+        };
+
+        // Filter active projects first to avoid unnecessary processing
+        const activeProjects = flattenedProjects.filter(project =>
+          project.status !== Project.Status.Done &&
+          project.status !== Project.Status.Dropped
+        );
+
+        // Pre-filter active tasks to avoid repeated filtering
+        const activeTasks = flattenedTasks.filter(task =>
+          task.taskStatus !== Task.Status.Completed &&
+          task.taskStatus !== Task.Status.Dropped
+        );
+
+        // Pre-filter active folders
+        const activeFolders = flattenedFolders.filter(folder =>
+          folder.status !== Folder.Status.Dropped
+        );
+
+        // Pre-filter active tags
+        const activeTags = flattenedTags.filter(tag => tag.active);
+
+        // Process projects in a single pass and store in Map for O(1) lookups
+        const projectsMap = new Map();
+        activeProjects.forEach(project => {
+          try {
+            const projectId = project.id.primaryKey;
+            const projectData = {
+              id: projectId,
+              name: project.name,
+              status: getEnumValue(project.status, projectStatusMap),
+              folderID: project.parentFolder ? project.parentFolder.id.primaryKey : null,
+              sequential: project.task.sequential || false,
+              effectiveDueDate: formatDate(project.effectiveDueDate),
+              effectiveDeferDate: formatDate(project.effectiveDeferDate),
+              dueDate: formatDate(project.dueDate),
+              deferDate: formatDate(project.deferDate),
+              completedByChildren: project.completedByChildren,
+              containsSingletonActions: project.containsSingletonActions,
+              note: project.note || "",
+              tasks: [] // Will be populated in the task loop
+            };
+            projectsMap.set(projectId, projectData);
+            exportData.projects[projectId] = projectData;
+          } catch (projectError) {
+            // Silently handle project processing errors
+          }
+        });
+
+        // Process folders in a single pass
+        const foldersMap = new Map();
+        activeFolders.forEach(folder => {
+          try {
+            const folderId = folder.id.primaryKey;
+            const folderData = {
+              id: folderId,
+              name: folder.name,
+              parentFolderID: folder.parent ? folder.parent.id.primaryKey : null,
+              status: getEnumValue(folder.status, folderStatusMap),
+              projects: [],
+              subfolders: []
+            };
+            foldersMap.set(folderId, folderData);
+            exportData.folders[folderId] = folderData;
+          } catch (folderError) {
+            // Silently handle folder processing errors
+          }
+        });
+
+        // Process tags in a single pass
+        const tagsMap = new Map();
+        activeTags.forEach(tag => {
+          try {
+            const tagId = tag.id.primaryKey;
+            const tagData = {
+              id: tagId,
+              name: tag.name,
+              parentTagID: tag.parent ? tag.parent.id.primaryKey : null,
+              active: tag.active,
+              allowsNextAction: tag.allowsNextAction,
+              tasks: []
+            };
+            tagsMap.set(tagId, tagData);
+            exportData.tags[tagId] = tagData;
+          } catch (tagError) {
+            // Silently handle tag processing errors
+          }
+        });
+
+        console.log("Building relationships and processing tasks simultaneously...");
+
+        // Build folder relationships and project-folder relationships as we go
+        foldersMap.forEach((folder, folderId) => {
+          if (folder.parentFolderID && foldersMap.has(folder.parentFolderID)) {
+            const parentFolder = foldersMap.get(folder.parentFolderID);
+            if (!parentFolder.subfolders.includes(folder.id)) {
+              parentFolder.subfolders.push(folder.id);
+            }
+          }
+        });
+
+        console.log(`Processing ${activeTasks.length} active tasks...`);
+
+        // Process tasks with an optimized approach
+        // Process in batches of 100 to prevent UI freezing
+        const BATCH_SIZE = 100;
+
+        for (let i = 0; i < activeTasks.length; i += BATCH_SIZE) {
+          const taskBatch = activeTasks.slice(i, i + BATCH_SIZE);
+
+          taskBatch.forEach(task => {
+            try {
+              // Get task data with minimal processing
+              const taskTags = task.tags.map(tag => tag.id.primaryKey);
+              const projectID = task.containingProject ? task.containingProject.id.primaryKey : null;
+
+              const taskData = {
+                id: task.id.primaryKey,
+                name: task.name,
+                note: task.note || "",
+                taskStatus: getEnumValue(task.taskStatus, taskStatusMap),
+                flagged: task.flagged,
+                dueDate: formatDate(task.dueDate),
+                deferDate: formatDate(task.deferDate),
+                effectiveDueDate: formatDate(task.effectiveDueDate),
+                effectiveDeferDate: formatDate(task.effectiveDeferDate),
+                estimatedMinutes: task.estimatedMinutes,
+                completedByChildren: task.completedByChildren,
+                sequential: task.sequential || false,
+                tags: taskTags,
+                projectID: projectID,
+                parentTaskID: task.parent ? task.parent.id.primaryKey : null,
+                children: task.children.map(child => child.id.primaryKey),
+                inInbox: task.inInbox
+              };
+
+              // Add task to export
+              exportData.tasks.push(taskData);
+
+              // Add task ID to associated project (if it exists)
+              if (projectID && projectsMap.has(projectID)) {
+                projectsMap.get(projectID).tasks.push(taskData.id);
+
+                // Update folder-project relationship (only once per project)
+                const project = projectsMap.get(projectID);
+                if (project.folderID && foldersMap.has(project.folderID)) {
+                  const folder = foldersMap.get(project.folderID);
+                  if (!folder.projects.includes(project.id)) {
+                    folder.projects.push(project.id);
+                  }
+                }
+              }
+
+              // Add task ID to associated tags
+              taskTags.forEach(tagID => {
+                if (tagsMap.has(tagID)) {
+                  tagsMap.get(tagID).tasks.push(taskData.id);
+                }
+              });
+            } catch (taskError) {
+              // Silently handle task processing errors
+            }
+          });
+        }
+
+        // Return the complete database export
+        const jsonData = JSON.stringify(exportData);
+        return jsonData;
+
+      } catch (error) {
+        return JSON.stringify({
+          success: false,
+          error: `Error exporting database: ${error}`
+        });
+      }
+    }
+  )();

data/lib/omnifocus_mcp/utils/script_execution.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require_relative "../infrastructure/script_runner"
+
+module OmnifocusMcp
+  module Utils
+    ScriptExecution = Infrastructure::ScriptRunner
+  end
+end

data/lib/omnifocus_mcp/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module OmnifocusMcp
+  VERSION = "1.0.0"
+end

data/lib/omnifocus_mcp.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "fast_mcp"
+
+require_relative "omnifocus_mcp/json_rpc_compat"
+OmnifocusMcp::JsonRpcCompat.apply!
+
+require_relative "omnifocus_mcp/version"
+require_relative "omnifocus_mcp/logger"
+require_relative "omnifocus_mcp/config"
+require_relative "omnifocus_mcp/result"
+require_relative "omnifocus_mcp/infrastructure"
+require_relative "omnifocus_mcp/infrastructure/apple_script"
+require_relative "omnifocus_mcp/infrastructure/apple_script_date_builder"
+require_relative "omnifocus_mcp/infrastructure/js_embed"
+require_relative "omnifocus_mcp/infrastructure/script_runner"
+require_relative "omnifocus_mcp/parsers"
+require_relative "omnifocus_mcp/parsers/apple_script_envelope"
+
+# Utils have no internal deps and underpin everything else.
+require_relative "omnifocus_mcp/utils/apple_script_envelope"
+require_relative "omnifocus_mcp/utils/apple_script_helpers"
+require_relative "omnifocus_mcp/utils/blank"
+require_relative "omnifocus_mcp/utils/date_filter"
+require_relative "omnifocus_mcp/utils/date_formatting"
+require_relative "omnifocus_mcp/utils/iso_date"
+require_relative "omnifocus_mcp/utils/script_execution"
+
+# Tool param structs (shared by primitives and MCP definitions).
+require_relative "omnifocus_mcp/tools/params"
+require_relative "omnifocus_mcp/tools/generators"
+require_relative "omnifocus_mcp/tools/operations"
+require_relative "omnifocus_mcp/tools/presenters"
+require_relative "omnifocus_mcp/tools/messages"
+require_relative "omnifocus_mcp/tools/generators/list_perspectives"
+require_relative "omnifocus_mcp/tools/generators/list_tags"
+require_relative "omnifocus_mcp/tools/generators/perspective_view"
+require_relative "omnifocus_mcp/tools/generators/query_omnifocus"
+require_relative "omnifocus_mcp/tools/generators/query_omnifocus_debug"
+require_relative "omnifocus_mcp/tools/generators/database_stats"
+require_relative "omnifocus_mcp/tools/generators/add_project"
+require_relative "omnifocus_mcp/tools/generators/add_omnifocus_task"
+require_relative "omnifocus_mcp/tools/generators/edit_item"
+require_relative "omnifocus_mcp/tools/generators/remove_item"
+require_relative "omnifocus_mcp/tools/operations/query_omnifocus"
+require_relative "omnifocus_mcp/tools/operations/query_omnifocus_debug"
+require_relative "omnifocus_mcp/tools/operations/database_stats"
+require_relative "omnifocus_mcp/tools/operations/add_omnifocus_task"
+require_relative "omnifocus_mcp/tools/operations/add_project"
+require_relative "omnifocus_mcp/tools/operations/batch_add_items"
+require_relative "omnifocus_mcp/tools/operations/batch_remove_items"
+require_relative "omnifocus_mcp/tools/operations/edit_item"
+require_relative "omnifocus_mcp/tools/operations/get_perspective_view"
+require_relative "omnifocus_mcp/tools/operations/list_perspectives"
+require_relative "omnifocus_mcp/tools/operations/list_tags"
+require_relative "omnifocus_mcp/tools/operations/remove_item"
+
+# Shared tool support (formatter + stats + helpers) used by definitions.
+require_relative "omnifocus_mcp/tools/presenters/batch_report"
+require_relative "omnifocus_mcp/tools/presenters/list_perspectives"
+require_relative "omnifocus_mcp/tools/presenters/list_tags"
+require_relative "omnifocus_mcp/tools/presenters/perspective_view"
+require_relative "omnifocus_mcp/tools/presenters/query_reply"
+require_relative "omnifocus_mcp/tools/batch_report"
+require_relative "omnifocus_mcp/tools/database_stats"
+require_relative "omnifocus_mcp/tools/presenters/query_results"
+require_relative "omnifocus_mcp/tools/query_omnifocus_formatter"
+require_relative "omnifocus_mcp/tools/query_statuses"
+require_relative "omnifocus_mcp/tools/definitions/date_formatter"
+require_relative "omnifocus_mcp/tools/definitions/key_normalizer"
+require_relative "omnifocus_mcp/tools/definitions/mcp_envelope"
+require_relative "omnifocus_mcp/tools/definitions/operation_factory"
+require_relative "omnifocus_mcp/tools/messages/add_omnifocus_task"
+require_relative "omnifocus_mcp/tools/messages/add_project"
+require_relative "omnifocus_mcp/tools/messages/batch_remove_items"
+require_relative "omnifocus_mcp/tools/messages/edit_item"
+require_relative "omnifocus_mcp/tools/messages/list_tools"
+require_relative "omnifocus_mcp/tools/messages/remove_item"
+
+# Tool definitions wrap primitives for MCP exposure.
+require_relative "omnifocus_mcp/tools/definitions/add_omnifocus_task_tool"
+require_relative "omnifocus_mcp/tools/definitions/add_project_tool"
+require_relative "omnifocus_mcp/tools/definitions/batch_add_items_tool"
+require_relative "omnifocus_mcp/tools/definitions/batch_remove_items_tool"
+require_relative "omnifocus_mcp/tools/definitions/edit_item_tool"
+require_relative "omnifocus_mcp/tools/definitions/get_perspective_view_tool"
+require_relative "omnifocus_mcp/tools/definitions/list_perspectives_tool"
+require_relative "omnifocus_mcp/tools/definitions/list_tags_tool"
+require_relative "omnifocus_mcp/tools/definitions/query_omnifocus_tool"
+require_relative "omnifocus_mcp/tools/definitions/remove_item_tool"
+
+# Resources (base must be loaded before its subclasses).
+require_relative "omnifocus_mcp/resources/base"
+require_relative "omnifocus_mcp/resources/flagged_resource"
+require_relative "omnifocus_mcp/resources/inbox_resource"
+require_relative "omnifocus_mcp/resources/perspective_resource"
+require_relative "omnifocus_mcp/resources/project_resource"
+require_relative "omnifocus_mcp/resources/stats_resource"
+require_relative "omnifocus_mcp/resources/today_resource"
+
+# MCP bootstrap depends on everything above.
+require_relative "omnifocus_mcp/mcp"

metadata

@@ -0,0 +1,166 @@
+--- !ruby/object:Gem::Specification
+name: omnifocus_mcp
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Henry Maddocks
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fast-mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+description: MCP server for OmniFocus on macOS, built on the fast-mcp gem. Exposes
+  OmniFocus tasks, projects, perspectives, and tags to MCP clients over stdio.
+email:
+- hmaddocks@me.com
+executables:
+- omnifocus-mcp
+extensions: []
+extra_rdoc_files: []
+files:
+- AGENTS.md
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/omnifocus-mcp
+- lib/omnifocus_mcp.rb
+- lib/omnifocus_mcp/config.rb
+- lib/omnifocus_mcp/infrastructure.rb
+- lib/omnifocus_mcp/infrastructure/.keep
+- lib/omnifocus_mcp/infrastructure/apple_script.rb
+- lib/omnifocus_mcp/infrastructure/apple_script_date_builder.rb
+- lib/omnifocus_mcp/infrastructure/js_embed.rb
+- lib/omnifocus_mcp/infrastructure/script_runner.rb
+- lib/omnifocus_mcp/json_rpc_compat.rb
+- lib/omnifocus_mcp/logger.rb
+- lib/omnifocus_mcp/mcp.rb
+- lib/omnifocus_mcp/parsers.rb
+- lib/omnifocus_mcp/parsers/.keep
+- lib/omnifocus_mcp/parsers/apple_script_envelope.rb
+- lib/omnifocus_mcp/resources/base.rb
+- lib/omnifocus_mcp/resources/flagged_resource.rb
+- lib/omnifocus_mcp/resources/inbox_resource.rb
+- lib/omnifocus_mcp/resources/perspective_resource.rb
+- lib/omnifocus_mcp/resources/project_resource.rb
+- lib/omnifocus_mcp/resources/stats_resource.rb
+- lib/omnifocus_mcp/resources/today_resource.rb
+- lib/omnifocus_mcp/result.rb
+- lib/omnifocus_mcp/tools/batch_report.rb
+- lib/omnifocus_mcp/tools/database_stats.rb
+- lib/omnifocus_mcp/tools/definitions/add_omnifocus_task_tool.rb
+- lib/omnifocus_mcp/tools/definitions/add_project_tool.rb
+- lib/omnifocus_mcp/tools/definitions/batch_add_items_tool.rb
+- lib/omnifocus_mcp/tools/definitions/batch_remove_items_tool.rb
+- lib/omnifocus_mcp/tools/definitions/date_formatter.rb
+- lib/omnifocus_mcp/tools/definitions/edit_item_tool.rb
+- lib/omnifocus_mcp/tools/definitions/get_perspective_view_tool.rb
+- lib/omnifocus_mcp/tools/definitions/key_normalizer.rb
+- lib/omnifocus_mcp/tools/definitions/list_perspectives_tool.rb
+- lib/omnifocus_mcp/tools/definitions/list_tags_tool.rb
+- lib/omnifocus_mcp/tools/definitions/mcp_envelope.rb
+- lib/omnifocus_mcp/tools/definitions/operation_factory.rb
+- lib/omnifocus_mcp/tools/definitions/query_omnifocus_tool.rb
+- lib/omnifocus_mcp/tools/definitions/remove_item_tool.rb
+- lib/omnifocus_mcp/tools/generators.rb
+- lib/omnifocus_mcp/tools/generators/.keep
+- lib/omnifocus_mcp/tools/generators/add_omnifocus_task.rb
+- lib/omnifocus_mcp/tools/generators/add_project.rb
+- lib/omnifocus_mcp/tools/generators/database_stats.rb
+- lib/omnifocus_mcp/tools/generators/edit_item.rb
+- lib/omnifocus_mcp/tools/generators/list_perspectives.rb
+- lib/omnifocus_mcp/tools/generators/list_tags.rb
+- lib/omnifocus_mcp/tools/generators/perspective_view.rb
+- lib/omnifocus_mcp/tools/generators/query_omnifocus.rb
+- lib/omnifocus_mcp/tools/generators/query_omnifocus_debug.rb
+- lib/omnifocus_mcp/tools/generators/remove_item.rb
+- lib/omnifocus_mcp/tools/messages.rb
+- lib/omnifocus_mcp/tools/messages/add_omnifocus_task.rb
+- lib/omnifocus_mcp/tools/messages/add_project.rb
+- lib/omnifocus_mcp/tools/messages/batch_remove_items.rb
+- lib/omnifocus_mcp/tools/messages/edit_item.rb
+- lib/omnifocus_mcp/tools/messages/list_tools.rb
+- lib/omnifocus_mcp/tools/messages/remove_item.rb
+- lib/omnifocus_mcp/tools/operations.rb
+- lib/omnifocus_mcp/tools/operations/add_omnifocus_task.rb
+- lib/omnifocus_mcp/tools/operations/add_project.rb
+- lib/omnifocus_mcp/tools/operations/batch_add_items.rb
+- lib/omnifocus_mcp/tools/operations/batch_add_items/batch_item.rb
+- lib/omnifocus_mcp/tools/operations/batch_add_items/bulk_executor.rb
+- lib/omnifocus_mcp/tools/operations/batch_add_items/cycle_detector.rb
+- lib/omnifocus_mcp/tools/operations/batch_add_items/param_builder.rb
+- lib/omnifocus_mcp/tools/operations/batch_add_items/planner.rb
+- lib/omnifocus_mcp/tools/operations/batch_remove_items.rb
+- lib/omnifocus_mcp/tools/operations/database_stats.rb
+- lib/omnifocus_mcp/tools/operations/edit_item.rb
+- lib/omnifocus_mcp/tools/operations/get_perspective_view.rb
+- lib/omnifocus_mcp/tools/operations/list_perspectives.rb
+- lib/omnifocus_mcp/tools/operations/list_tags.rb
+- lib/omnifocus_mcp/tools/operations/query_omnifocus.rb
+- lib/omnifocus_mcp/tools/operations/query_omnifocus_debug.rb
+- lib/omnifocus_mcp/tools/operations/remove_item.rb
+- lib/omnifocus_mcp/tools/params.rb
+- lib/omnifocus_mcp/tools/params/mcp_boundary.rb
+- lib/omnifocus_mcp/tools/presenters.rb
+- lib/omnifocus_mcp/tools/presenters/batch_report.rb
+- lib/omnifocus_mcp/tools/presenters/list_perspectives.rb
+- lib/omnifocus_mcp/tools/presenters/list_tags.rb
+- lib/omnifocus_mcp/tools/presenters/perspective_view.rb
+- lib/omnifocus_mcp/tools/presenters/query_reply.rb
+- lib/omnifocus_mcp/tools/presenters/query_results.rb
+- lib/omnifocus_mcp/tools/query_omnifocus_formatter.rb
+- lib/omnifocus_mcp/tools/query_statuses.rb
+- lib/omnifocus_mcp/utils/apple_script.rb
+- lib/omnifocus_mcp/utils/apple_script_envelope.rb
+- lib/omnifocus_mcp/utils/apple_script_helpers.rb
+- lib/omnifocus_mcp/utils/blank.rb
+- lib/omnifocus_mcp/utils/date_filter.rb
+- lib/omnifocus_mcp/utils/date_formatting.rb
+- lib/omnifocus_mcp/utils/iso_date.rb
+- lib/omnifocus_mcp/utils/omnifocus_scripts/getPerspectiveView.js
+- lib/omnifocus_mcp/utils/omnifocus_scripts/listPerspectives.js
+- lib/omnifocus_mcp/utils/omnifocus_scripts/listTags.js
+- lib/omnifocus_mcp/utils/omnifocus_scripts/omnifocusDump.js
+- lib/omnifocus_mcp/utils/script_execution.rb
+- lib/omnifocus_mcp/version.rb
+homepage: https://github.com/hmaddocks/omnifocus-mcp
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/hmaddocks/omnifocus-mcp
+  source_code_uri: https://github.com/hmaddocks/omnifocus-mcp
+  changelog_uri: https://github.com/hmaddocks/omnifocus-mcp/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.12
+specification_version: 4
+summary: MCP server bridging LLM clients to OmniFocus on macOS.
+test_files: []