addTaskManager MCP Server

Instructions

Implementation Reference

• src/index.ts:628-632 (registration)

  Tool registration in ListToolsRequestSchema handler, including name, description, and empty input schema (no parameters required).
  { name: 'get_tasks_soon_in_do', description: 'Find tasks due soon in Do realm.', inputSchema: { type: 'object', properties: {} } },
• src/index.ts:772-773 (handler)

  Dispatch in CallToolRequestSchema switch statement that invokes the main handler method.
  case 'get_tasks_soon_in_do': return await this.getTasksSoonInDo();
• src/index.ts:1842-1911 (handler)

  Primary MCP tool handler. In production, delegates to CloudKitService.getTasksInDoSoon() and formats response. In development/mock mode, returns simulated data with tasks due in 2-7 days.
  private async getTasksSoonInDo() { return this.withCloudKitOrMock( 'getTasksSoonInDo', async () => { // CloudKit production implementation const soonTasks = await this.cloudKitService.getTasksInDoSoon(); let response = `Soon items in Do realm (due within next 2-7 days):\n`; if (soonTasks.length === 0) { response += 'No tasks due soon in Do realm! 📋 Good planning ahead!'; } else { response += soonTasks.map((task: any) => { const name = task.fields?.taskName?.value || 'Unnamed Task'; const contextRecordName = task.fields?.context?.value?.recordName; const contextName = contextRecordName?.replace('context_', '') || 'No context'; const priority = task.fields?.taskPriority?.value || 3; const priorityIcon = priority === 1 ? '🔴 High' : priority === 2 ? '🟡 Medium' : '🟢 Low'; const endDate = task.fields?.endDate?.value; const dueDate = new Date(endDate).toLocaleDateString(); const daysUntil = Math.ceil((new Date(endDate).getTime() - Date.now()) / (24 * 60 * 60 * 1000)); return `- ${name} (${task.recordName}) - Due: ${dueDate} (${daysUntil} days) - ${contextName} - ${priorityIcon}`; }).join('\n'); } return { content: [{ type: 'text', text: response }] }; }, async () => { // Mock implementation const now = new Date(); const threeDays = new Date(now.getTime() + 3 * 86400000); const sevenDays = new Date(now.getTime() + 7 * 86400000); const mockTasks = [ { recordName: 'task_soon_1', taskName: 'Submit tax documents', realmId: 3, endDate: threeDays.toISOString().split('T')[0], contextRecordName: 'context_personal', priority: 1, timeEstimate: '2 hours', daysUntilDue: 3 }, { recordName: 'project_soon_1', projectName: 'Plan team offsite', realmId: 3, endDate: sevenDays.toISOString().split('T')[0], contextRecordName: 'context_work', priority: 2, timeEstimate: '5 hours', daysUntilDue: 7 } ]; let response = `Soon items in Do realm (due within next 2-7 days):\n`; response += mockTasks.map(item => { const type = item.recordName.startsWith('task_') ? 'Task' : 'Project'; const name = item.taskName || (item as any).projectName; const contextName = item.contextRecordName?.replace('context_', '') || 'No context'; const priority = item.priority === 1 ? '🔴 High' : item.priority === 2 ? '🟡 Medium' : '🟢 Low'; const dueDate = new Date(item.endDate).toLocaleDateString(); return `- ${name} (${item.recordName}) - Due: ${dueDate} (${item.daysUntilDue} days) - ${contextName} - ${priority}`; }).join('\n'); return { content: [{ type: 'text', text: response }] }; } ); }
• src/services/CloudKitService.ts:378-393 (handler)

  Production CloudKit query implementation: fetches Tasks in Do realm (realmId=3) with endDate between +2 and +7 days from now, sorted by endDate ascending.
  async getTasksInDoSoon(): Promise<ZenTaskticTask[]> { const twoDaysFromNow = new Date(); twoDaysFromNow.setDate(twoDaysFromNow.getDate() + 2); const sevenDaysFromNow = new Date(); sevenDaysFromNow.setDate(sevenDaysFromNow.getDate() + 7); return this.queryRecords<ZenTaskticTask>('Task', { filterBy: [ { fieldName: 'realmId', fieldValue: 3, comparator: 'EQUALS' }, { fieldName: 'endDate', fieldValue: twoDaysFromNow.getTime(), comparator: 'GREATER_THAN_OR_EQUALS' }, { fieldName: 'endDate', fieldValue: sevenDaysFromNow.getTime(), comparator: 'LESS_THAN_OR_EQUALS' } ], sortBy: [{ fieldName: 'endDate', ascending: true }] }); }