omnifocus-mcp-enhanced 1.6.8 → 1.6.9

package/README.md

@@ -17,6 +17,7 @@ Enhanced Model Context Protocol (MCP) server for OmniFocus featuring **native cu
 
 ## 🆕 Latest Release
 
+- **v1.6.9** - Added task attachment support: `get_task_by_id` now lists attachment metadata, `dump_database` exports attachment/link metadata, and new `read_task_attachment` returns image attachments as MCP image content when possible.
 - **v1.6.8** - Added stable task move support via `move_task` and `edit_item` (`newProjectId/newProjectName/newParentTaskId/newParentTaskName/moveToInbox`) with duplicate-name protection and cycle-prevention checks.
 - **v1.6.6** - Added full Planned Date support (create/edit/read/filter/sort/export), including `plannedDate`/`newPlannedDate` and updated task displays.
 
@@ -38,6 +39,7 @@ Enhanced Model Context Protocol (MCP) server for OmniFocus featuring **native cu
 - **📅 Time Management** - Due, defer, planned dates, estimates, and scheduling
 - **🏷️ Advanced Tagging** - Tag-based filtering with exact/partial matching
 - **🤖 AI Integration** - Seamless Claude AI integration for intelligent workflows
+- **🖼️ Attachment-Aware Reads** - Surface note attachments and linked files before deciding whether AI should inspect them
 
 ## 📦 Installation
 
@@ -215,6 +217,25 @@ Efficiently manage multiple tasks:
 }
 ```
 
+### 6. 🖼️ Attachment Inspection
+
+Discover images and linked files on a task first, then read only the attachment you need:
+
+```bash
+# List task details plus attachment metadata
+get_task_by_id {
+  "taskId": "abc123"
+}
+
+# Open an attachment returned by get_task_by_id
+read_task_attachment {
+  "taskId": "abc123",
+  "attachmentId": "embedded-1"
+}
+```
+
+`get_task_by_id` now reports attachment IDs, names, MIME guesses, source (`embedded` vs `linked`), and sizes when available. `read_task_attachment` returns images as MCP image content when possible, so AI clients can inspect the image directly instead of parsing base64 from plain text.
+
 ## 🛠️ Complete Tool Reference
 
 ### 📊 Database & Task Management
@@ -226,21 +247,22 @@ Efficiently manage multiple tasks:
 6. **move_task** - Move an existing task to project/parent task/inbox
 7. **batch_add_items** - Bulk add (enhanced with subtask support)
 8. **batch_remove_items** - Bulk remove
-9. **get_task_by_id** - Query task information
+9. **get_task_by_id** - Query task information, including attachment metadata
+10. **read_task_attachment** - Read an attachment reported by `get_task_by_id`
 
 ### 🔍 Built-in Perspective Tools
-10. **get_inbox_tasks** - Inbox perspective
-11. **get_flagged_tasks** - Flagged perspective
-12. **get_forecast_tasks** - Forecast perspective (due/deferred/planned task data included)
-13. **get_tasks_by_tag** - Tag-based filtering
-14. **filter_tasks** - Ultimate filtering with unlimited combinations
+11. **get_inbox_tasks** - Inbox perspective
+12. **get_flagged_tasks** - Flagged perspective
+13. **get_forecast_tasks** - Forecast perspective (due/deferred/planned task data included)
+14. **get_tasks_by_tag** - Tag-based filtering
+15. **filter_tasks** - Ultimate filtering with unlimited combinations
 
 ### 🌟 Custom Perspective Tools (NEW)
-15. **list_custom_perspectives** - 🌟 **NEW**: List all custom perspectives with details
-16. **get_custom_perspective_tasks** - 🌟 **NEW**: Access custom perspective with hierarchical display
+16. **list_custom_perspectives** - 🌟 **NEW**: List all custom perspectives with details
+17. **get_custom_perspective_tasks** - 🌟 **NEW**: Access custom perspective with hierarchical display
 
 ### 📊 Analytics & Tracking
-17. **get_today_completed_tasks** - View today's completed tasks
+18. **get_today_completed_tasks** - View today's completed tasks
 
 Batch move feature roadmap (future): [docs/roadmap/2026-02-25-batch-move-tasks-plan.md](docs/roadmap/2026-02-25-batch-move-tasks-plan.md)
 

package/README.zh.md

@@ -13,6 +13,7 @@
 
 ## 🆕 最新版本
 
+- **v1.6.9** - 新增任务附件支持：`get_task_by_id` 会返回附件元信息，`dump_database` 导出附件/链接元信息，并新增 `read_task_attachment`，可在支持时直接把图片附件作为 MCP 图片内容返回。
 - **v1.6.6** - 新增 Planned Date（计划日期）全链路支持：创建/编辑/读取/过滤/排序/导出，包含 `plannedDate` / `newPlannedDate`。
 
 ## ✨ 核心特性
@@ -33,6 +34,7 @@
 - **📅 时间管理** - 截止日期、推迟日期、计划日期、估时和计划
 - **🏷️ 高级标签** - 基于标签的精确/模糊匹配过滤
 - **🤖 AI 集成** - 与 Claude AI 无缝集成，实现智能工作流
+- **🖼️ 附件感知读取** - 先暴露备注附件和链接文件的元信息，再决定是否让 AI 继续查看附件内容
 
 ## 📦 安装
 
@@ -210,6 +212,25 @@ get_custom_perspective_tasks {
 }
 ```
 
+### 6. 🖼️ 附件查看
+
+先读取任务和附件元信息，再按需打开具体附件：
+
+```bash
+# 读取任务详情和附件元信息
+get_task_by_id {
+  "taskId": "abc123"
+}
+
+# 打开 get_task_by_id 返回的某个附件
+read_task_attachment {
+  "taskId": "abc123",
+  "attachmentId": "embedded-1"
+}
+```
+
+`get_task_by_id` 现在会返回附件 ID、名称、推断出的 MIME 类型、来源（`embedded` 或 `linked`）以及可用时的大小。`read_task_attachment` 会尽量把图片作为 MCP 图片内容直接返回，这样 AI 客户端可以直接查看图片，而不是只能读一段 base64 文本。
+
 ## 🛠️ 完整工具参考
 
 ### 📊 数据库与任务管理
@@ -221,21 +242,22 @@ get_custom_perspective_tasks {
 6. **move_task** - 将已有任务转移到项目/父任务/Inbox
 7. **batch_add_items** - 批量添加（增强子任务支持）
 8. **batch_remove_items** - 批量删除
-9. **get_task_by_id** - 查询任务信息
+9. **get_task_by_id** - 查询任务信息，并返回附件元信息
+10. **read_task_attachment** - 读取 `get_task_by_id` 返回的任务附件
 
 ### 🔍 内置透视工具
-10. **get_inbox_tasks** - 收件箱透视
-11. **get_flagged_tasks** - 已标记透视
-12. **get_forecast_tasks** - 预测透视（包含截止/推迟/计划日期任务数据）
-13. **get_tasks_by_tag** - 基于标签的过滤
-14. **filter_tasks** - 无限组合的终极过滤
+11. **get_inbox_tasks** - 收件箱透视
+12. **get_flagged_tasks** - 已标记透视
+13. **get_forecast_tasks** - 预测透视（包含截止/推迟/计划日期任务数据）
+14. **get_tasks_by_tag** - 基于标签的过滤
+15. **filter_tasks** - 无限组合的终极过滤
 
 ### 🌟 自定义透视工具（新功能）
-15. **list_custom_perspectives** - 🌟 **新功能**：列出所有自定义透视及详情
-16. **get_custom_perspective_tasks** - 🌟 **新功能**：访问自定义透视，支持层级显示
+16. **list_custom_perspectives** - 🌟 **新功能**：列出所有自定义透视及详情
+17. **get_custom_perspective_tasks** - 🌟 **新功能**：访问自定义透视，支持层级显示
 
 ### 📊 分析与跟踪
-17. **get_today_completed_tasks** - 查看今日完成的任务
+18. **get_today_completed_tasks** - 查看今日完成的任务
 
 批量转移功能后续计划（Roadmap）：[docs/roadmap/2026-02-25-batch-move-tasks-plan.zh.md](docs/roadmap/2026-02-25-batch-move-tasks-plan.zh.md)
 

package/dist/server.js

@@ -11,6 +11,7 @@ import * as moveTaskTool from './tools/definitions/moveTask.js';
 import * as batchAddItemsTool from './tools/definitions/batchAddItems.js';
 import * as batchRemoveItemsTool from './tools/definitions/batchRemoveItems.js';
 import * as getTaskByIdTool from './tools/definitions/getTaskById.js';
+import * as readTaskAttachmentTool from './tools/definitions/readTaskAttachment.js';
 import * as getTodayCompletedTasksTool from './tools/definitions/getTodayCompletedTasks.js';
 // Import perspective tools
 import * as getInboxTasksTool from './tools/definitions/getInboxTasks.js';
@@ -25,7 +26,7 @@ import * as getCustomPerspectiveTasksTool from './tools/definitions/getCustomPer
 // Create an MCP server
 const server = new McpServer({
     name: "OmniFocus MCP",
-    version: "1.6.6"
+    version: "1.6.9"
 });
 // Register tools
 server.tool("dump_database", "Gets the current state of your OmniFocus database", dumpDatabaseTool.schema.shape, dumpDatabaseTool.handler);
@@ -37,6 +38,7 @@ server.tool("move_task", "Move an existing task to a project, parent task, or in
 server.tool("batch_add_items", "Add multiple tasks or projects to OmniFocus in a single operation", batchAddItemsTool.schema.shape, batchAddItemsTool.handler);
 server.tool("batch_remove_items", "Remove multiple tasks or projects from OmniFocus in a single operation", batchRemoveItemsTool.schema.shape, batchRemoveItemsTool.handler);
 server.tool("get_task_by_id", "Get information about a specific task by ID or name", getTaskByIdTool.schema.shape, getTaskByIdTool.handler);
+server.tool("read_task_attachment", "Read a task attachment reported by get_task_by_id. Images are returned as MCP image content when possible.", readTaskAttachmentTool.schema.shape, readTaskAttachmentTool.handler);
 server.tool("get_today_completed_tasks", "Get tasks completed today - view today's accomplishments", getTodayCompletedTasksTool.schema.shape, getTodayCompletedTasksTool.handler);
 // Register perspective tools
 server.tool("get_inbox_tasks", "Get tasks from OmniFocus inbox perspective", getInboxTasksTool.schema.shape, getInboxTasksTool.handler);

package/dist/tools/definitions/getTaskById.js

@@ -1,9 +1,42 @@
 import { z } from 'zod';
 import { getTaskById } from '../primitives/getTaskById.js';
+import { formatAttachmentSize } from '../primitives/taskAttachments.js';
 export const schema = z.object({
     taskId: z.string().optional().describe("The ID of the task to retrieve"),
     taskName: z.string().optional().describe("The name of the task to retrieve (alternative to taskId)")
 });
+export function formatTaskInfo(task) {
+    let infoText = `📋 **Task Information**\n`;
+    infoText += `• **Name**: ${task.name}\n`;
+    infoText += `• **ID**: ${task.id}\n`;
+    if (task.note) {
+        infoText += `• **Note**: ${task.note}\n`;
+    }
+    if (task.parentId && task.parentName) {
+        infoText += `• **Parent Task**: ${task.parentName} (${task.parentId})\n`;
+    }
+    if (task.projectId && task.projectName) {
+        infoText += `• **Project**: ${task.projectName} (${task.projectId})\n`;
+    }
+    if (task.dueDate) {
+        infoText += `• **Due**: ${new Date(task.dueDate).toLocaleString()}\n`;
+    }
+    if (task.deferDate) {
+        infoText += `• **Defer**: ${new Date(task.deferDate).toLocaleString()}\n`;
+    }
+    if (task.plannedDate) {
+        infoText += `• **Planned**: ${new Date(task.plannedDate).toLocaleString()}\n`;
+    }
+    infoText += `• **Has Children**: ${task.hasChildren ? `Yes (${task.childrenCount} subtasks)` : 'No'}\n`;
+    infoText += `• **Attachments**: ${task.attachments.length}\n`;
+    if (task.attachments.length > 0) {
+        task.attachments.forEach(attachment => {
+            infoText += `  - ${attachment.id}: ${attachment.name} [${attachment.kind}, ${attachment.mimeType || 'unknown'}, ${attachment.source}, ${formatAttachmentSize(attachment.sizeBytes)}]\n`;
+        });
+        infoText += `• Use read_task_attachment with an attachment ID or name when you need to inspect the file.\n`;
+    }
+    return infoText;
+}
 export async function handler(args, extra) {
     try {
         // Validate that either taskId or taskName is provided
@@ -19,34 +52,10 @@ export async function handler(args, extra) {
         // Call the getTaskById function
         const result = await getTaskById(args);
         if (result.success && result.task) {
-            const task = result.task;
-            // Format task information for display
-            let infoText = `📋 **Task Information**\n`;
-            infoText += `• **Name**: ${task.name}\n`;
-            infoText += `• **ID**: ${task.id}\n`;
-            if (task.note) {
-                infoText += `• **Note**: ${task.note}\n`;
-            }
-            if (task.parentId && task.parentName) {
-                infoText += `• **Parent Task**: ${task.parentName} (${task.parentId})\n`;
-            }
-            if (task.projectId && task.projectName) {
-                infoText += `• **Project**: ${task.projectName} (${task.projectId})\n`;
-            }
-            if (task.dueDate) {
-                infoText += `• **Due**: ${new Date(task.dueDate).toLocaleString()}\n`;
-            }
-            if (task.deferDate) {
-                infoText += `• **Defer**: ${new Date(task.deferDate).toLocaleString()}\n`;
-            }
-            if (task.plannedDate) {
-                infoText += `• **Planned**: ${new Date(task.plannedDate).toLocaleString()}\n`;
-            }
-            infoText += `• **Has Children**: ${task.hasChildren ? `Yes (${task.childrenCount} subtasks)` : 'No'}\n`;
             return {
                 content: [{
                         type: "text",
-                        text: infoText
+                        text: formatTaskInfo(result.task)
                     }]
             };
         }

package/dist/tools/definitions/getTaskById.test.js

@@ -0,0 +1,32 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { formatTaskInfo } from './getTaskById.js';
+test('formatTaskInfo includes attachment metadata for follow-up reads', () => {
+    const output = formatTaskInfo({
+        id: 'task-1',
+        name: 'Review screenshots',
+        note: 'Latest UI mocks are attached',
+        hasChildren: false,
+        childrenCount: 0,
+        tags: ['design'],
+        flagged: false,
+        completed: false,
+        linkedFileURLs: [],
+        attachments: [
+            {
+                id: 'embedded-1',
+                name: 'ui-mock.png',
+                kind: 'image',
+                mimeType: 'image/png',
+                sizeBytes: 4096,
+                source: 'embedded',
+                isImage: true
+            }
+        ]
+    });
+    assert.match(output, /Attachments\*\*: 1/);
+    assert.match(output, /embedded-1/);
+    assert.match(output, /ui-mock\.png/);
+    assert.match(output, /image\/png/);
+    assert.match(output, /Use read_task_attachment/);
+});

package/dist/tools/definitions/readTaskAttachment.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { readTaskAttachment, validateReadTaskAttachmentParams } from '../primitives/readTaskAttachment.js';
+import { formatAttachmentSize } from '../primitives/taskAttachments.js';
+export const schema = z.object({
+    taskId: z.string().optional().describe('The ID of the task that owns the attachment'),
+    taskName: z.string().optional().describe('The name of the task that owns the attachment'),
+    attachmentId: z.string().optional().describe('The attachment ID reported by get_task_by_id'),
+    attachmentName: z.string().optional().describe('The attachment name reported by get_task_by_id')
+});
+export function buildAttachmentContentResponse(result) {
+    const attachment = result.attachment;
+    const summary = `📎 **Attachment**\n` +
+        `• **Name**: ${attachment.name}\n` +
+        `• **ID**: ${attachment.id}\n` +
+        `• **Source**: ${attachment.source}\n` +
+        `• **Type**: ${attachment.kind}\n` +
+        `• **MIME**: ${attachment.mimeType || 'unknown'}\n` +
+        `• **Size**: ${formatAttachmentSize(attachment.sizeBytes)}\n`;
+    const content = [
+        {
+            type: 'text',
+            text: summary
+        }
+    ];
+    if (attachment.isImage && attachment.mimeType && result.content.base64) {
+        content.push({
+            type: 'image',
+            data: result.content.base64,
+            mimeType: attachment.mimeType
+        });
+        return { content };
+    }
+    if (result.content.text) {
+        content.push({
+            type: 'text',
+            text: result.content.text
+        });
+        return { content };
+    }
+    if (result.content.base64) {
+        content.push({
+            type: 'text',
+            text: `Base64 content:\n${result.content.base64}`
+        });
+    }
+    return { content };
+}
+export async function handler(args, extra) {
+    const validation = validateReadTaskAttachmentParams(args);
+    if (!validation.valid) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Error: ${validation.error}`
+                }],
+            isError: true
+        };
+    }
+    const result = await readTaskAttachment(args);
+    if (!result.success || !result.attachment || !result.content) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to read attachment: ${result.error}`
+                }],
+            isError: true
+        };
+    }
+    return buildAttachmentContentResponse({
+        attachment: result.attachment,
+        content: result.content
+    });
+}

package/dist/tools/definitions/readTaskAttachment.test.js

@@ -0,0 +1,32 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { buildAttachmentContentResponse, schema } from './readTaskAttachment.js';
+test('read_task_attachment schema preserves task and attachment selectors', () => {
+    const parsed = schema.parse({
+        taskId: 'task-1',
+        attachmentId: 'embedded-1'
+    });
+    assert.equal(parsed.taskId, 'task-1');
+    assert.equal(parsed.attachmentId, 'embedded-1');
+});
+test('buildAttachmentContentResponse returns image content blocks for image attachments', () => {
+    const response = buildAttachmentContentResponse({
+        attachment: {
+            id: 'embedded-1',
+            name: 'annotated.png',
+            kind: 'image',
+            mimeType: 'image/png',
+            sizeBytes: 12,
+            source: 'embedded',
+            isImage: true
+        },
+        content: {
+            base64: 'QUJDRA=='
+        }
+    });
+    assert.equal(response.content[0].type, 'text');
+    assert.match(response.content[0].text, /annotated\.png/);
+    assert.equal(response.content[1].type, 'image');
+    assert.equal(response.content[1].mimeType, 'image/png');
+    assert.equal(response.content[1].data, 'QUJDRA==');
+});

package/dist/tools/dumpDatabase.js

@@ -1,4 +1,5 @@
 import { executeOmniFocusScript } from '../utils/scriptExecution.js';
+import { normalizeTaskAttachments } from './primitives/taskAttachments.js';
 // Main function to dump the database
 export async function dumpDatabase() {
     try {
@@ -58,8 +59,8 @@ export async function dumpDatabase() {
                     isRepeating: false, // Not available in the new format
                     repetitionMethod: null, // Not available in the new format 
                     repetitionRule: null, // Not available in the new format
-                    attachments: [], // Default empty array
-                    linkedFileURLs: [], // Default empty array
+                    attachments: normalizeTaskAttachments(task.attachments, task.linkedFileURLs),
+                    linkedFileURLs: task.linkedFileURLs || [],
                     notifications: [], // Default empty array
                     shouldUseFloatingTimeZone: false // Default value
                 };

package/dist/tools/primitives/getTaskById.js

@@ -1,108 +1,5 @@
-import { executeAppleScript } from '../../utils/scriptExecution.js';
-/**
- * Generate AppleScript to get task information by ID or name
- */
-function generateGetTaskScript(params) {
-    const taskId = params.taskId?.replace(/['"\\]/g, '\\$&') || '';
-    const taskName = params.taskName?.replace(/['"\\]/g, '\\$&') || '';
-    let script = `
-  try
-    tell application "OmniFocus"
-      tell front document
-        -- Find task by ID or name
-        if "${taskId}" is not "" then
-          set theTask to first flattened task where id = "${taskId}"
-        else if "${taskName}" is not "" then
-          set theTask to first flattened task where name = "${taskName}"
-        else
-          return "{\\\"success\\\":false,\\\"error\\\":\\\"Either taskId or taskName must be provided\\\"}"
-        end if
-        
-        -- Get task information
-        set taskId to id of theTask as string
-        set taskName to name of theTask
-        set taskNote to note of theTask
-        set taskChildren to tasks of theTask
-        set childrenCount to count of taskChildren
-        set hasChildren to (childrenCount > 0)
-        
-        -- Get parent information
-        set parentId to ""
-        set parentName to ""
-        try
-          set parentTask to container of theTask
-          if class of parentTask is task then
-            set parentId to id of parentTask as string
-            set parentName to name of parentTask
-          end if
-        end try
-        
-        -- Get project information
-        set projectId to ""
-        set projectName to ""
-        try
-          set containingProject to containing project of theTask
-          if containingProject is not missing value then
-            set projectId to id of containingProject as string
-            set projectName to name of containingProject
-          end if
-        end try
-        
-        -- Get tags
-        set taskTags to tags of theTask
-        set tagNames to ""
-        if (count of taskTags) > 0 then
-          set tagList to {}
-          repeat with taskTag in taskTags
-            set end of tagList to "\\"" & (name of taskTag) & "\\""
-          end repeat
-          set AppleScript's text item delimiters to ","
-          set tagNames to tagList as string
-          set AppleScript's text item delimiters to ""
-        end if
-        
-        -- Get other properties
-        set taskFlagged to flagged of theTask
-        set taskCompleted to completed of theTask
-        set taskDueDate to ""
-        set taskDeferDate to ""
-        set taskPlannedDate to ""
-        set taskEstimatedMinutes to ""
-        
-        try
-          if due date of theTask is not missing value then
-            set taskDueDate to (due date of theTask) as string
-          end if
-        end try
-        
-        try
-          if defer date of theTask is not missing value then
-            set taskDeferDate to (defer date of theTask) as string
-          end if
-        end try
-
-        try
-          if planned date of theTask is not missing value then
-            set taskPlannedDate to (planned date of theTask) as string
-          end if
-        end try
-        
-        try
-          if estimated minutes of theTask is not missing value then
-            set taskEstimatedMinutes to (estimated minutes of theTask) as string
-          end if
-        end try
-        
-        -- Return simple pipe-delimited result to avoid JSON escaping issues
-        return "SUCCESS|" & taskId & "|" & taskName & "|" & taskNote & "|" & parentId & "|" & parentName & "|" & projectId & "|" & projectName & "|" & hasChildren & "|" & childrenCount & "|" & tagNames & "|" & taskDueDate & "|" & taskDeferDate & "|" & taskPlannedDate & "|" & taskFlagged & "|" & taskCompleted & "|" & taskEstimatedMinutes
-      end tell
-    end tell
-  on error errorMessage
-    return "{\\\"success\\\":false,\\\"error\\\":\\"" & errorMessage & "\\"}"
-  end try
-  `;
-    return script;
-}
+import { executeOmniFocusScript } from '../../utils/scriptExecution.js';
+import { normalizeTaskAttachments } from './taskAttachments.js';
 /**
  * Get task information by ID or name from OmniFocus
  */
@@ -115,64 +12,38 @@ export async function getTaskById(params) {
                 error: "Either taskId or taskName must be provided"
             };
         }
-        // Generate AppleScript
-        const script = generateGetTaskScript(params);
-        console.error("Generated getTaskById AppleScript:");
-        console.error(script);
-        console.error("Executing getTaskById AppleScript...");
-        // Execute AppleScript using temp file (avoids shell escaping issues)
-        const stdout = await executeAppleScript(script);
-        console.error("AppleScript stdout:", stdout);
-        // Parse the result
-        try {
-            if (stdout.startsWith('SUCCESS|')) {
-                // Parse pipe-delimited format
-                const parts = stdout.substring(8).split('|'); // Remove "SUCCESS|" prefix
-                const [id, name, note, parentId, parentName, projectId, projectName, hasChildrenStr, childrenCountStr, tagNamesStr, dueDate, deferDate, plannedDate, flaggedStr, completedStr, estimatedMinutesStr] = parts;
-                // Parse tags from comma-separated quoted strings
-                let tags = [];
-                if (tagNamesStr && tagNamesStr.trim() !== '') {
-                    tags = tagNamesStr.split(',').map(tag => tag.replace(/^"(.*)"$/, '$1'));
-                }
-                const taskInfo = {
-                    id,
-                    name,
-                    note,
-                    parentId: parentId || undefined,
-                    parentName: parentName || undefined,
-                    projectId: projectId || undefined,
-                    projectName: projectName || undefined,
-                    hasChildren: hasChildrenStr === 'true',
-                    childrenCount: parseInt(childrenCountStr) || 0,
-                    tags,
-                    dueDate: dueDate || undefined,
-                    deferDate: deferDate || undefined,
-                    plannedDate: plannedDate || undefined,
-                    flagged: flaggedStr === 'true',
-                    completed: completedStr === 'true',
-                    estimatedMinutes: estimatedMinutesStr ? parseInt(estimatedMinutesStr) : undefined
-                };
-                return {
-                    success: true,
-                    task: taskInfo
-                };
-            }
-            else {
-                // Try JSON parsing for error messages
-                const result = JSON.parse(stdout);
-                return {
-                    success: false,
-                    error: result.error
-                };
-            }
-        }
-        catch (parseError) {
-            console.error("Error parsing AppleScript result:", parseError);
+        const result = await executeOmniFocusScript('@getTaskById.js', params);
+        if (!result.success || !result.task) {
             return {
                 success: false,
-                error: `Failed to parse result: ${stdout}`
+                error: result.error || 'Failed to retrieve task'
             };
         }
+        const rawTask = result.task;
+        const taskInfo = {
+            id: rawTask.id,
+            name: rawTask.name,
+            note: rawTask.note || '',
+            parentId: rawTask.parentId || undefined,
+            parentName: rawTask.parentName || undefined,
+            projectId: rawTask.projectId || undefined,
+            projectName: rawTask.projectName || undefined,
+            hasChildren: Boolean(rawTask.hasChildren),
+            childrenCount: rawTask.childrenCount || 0,
+            tags: rawTask.tags || [],
+            dueDate: rawTask.dueDate || undefined,
+            deferDate: rawTask.deferDate || undefined,
+            plannedDate: rawTask.plannedDate || undefined,
+            flagged: Boolean(rawTask.flagged),
+            completed: Boolean(rawTask.completed),
+            estimatedMinutes: rawTask.estimatedMinutes ?? undefined,
+            attachments: normalizeTaskAttachments(rawTask.attachments, rawTask.linkedFileURLs),
+            linkedFileURLs: rawTask.linkedFileURLs || []
+        };
+        return {
+            success: true,
+            task: taskInfo
+        };
     }
     catch (error) {
         console.error("Error in getTaskById:", error);