addTaskManager MCP Server

Instructions

Implementation Reference

• src/index.ts:1350-1353 (handler)

  The core handler function implementing the tool logic. Currently a mock that returns a success message simulating the addition of a task to a project via CloudKit.

  private async addTaskToProject(taskRecordName: string, projectRecordName: string) {
    // Mock adding task to project via CloudKit
    return { content: [{ type: 'text', text: `Task ${taskRecordName} added to project ${projectRecordName}` }] };
  }

• src/index.ts:683-685 (registration)

  Tool dispatching/registration in the CallToolRequestSchema switch statement, validating args and calling the handler.

  case 'assess_add_task_to_project':
    this.validateArgs(args, ['taskRecordName', 'projectRecordName']);
    return await this.addTaskToProject(args.taskRecordName, args.projectRecordName);

• src/index.ts:354-363 (schema)

  Tool definition including name, description, and input schema registered in ListToolsRequestSchema response.

  name: 'assess_add_task_to_project',
  description: 'Add an existing task to a project in Assess realm.',
  inputSchema: {
    type: 'object',
    properties: {
      taskRecordName: { type: 'string', description: 'Record name of the task' },
      projectRecordName: { type: 'string', description: 'Record name of the project' }
    },
    required: ['taskRecordName', 'projectRecordName']
  }

• src/index.ts:238-638 (registration)

  Full tools list including this tool's registration in ListToolsRequestSchema handler (excerpt shows context). Note: full block spans lines 238-638.

  return {
    tools: [
      // Authentication
      {
        name: 'authenticate_user',
        description: 'Authenticate user with Apple ID to access their addTaskManager data',
        inputSchema: {
          type: 'object',
          properties: {
            webAuthToken: { type: 'string', description: 'CloudKit web auth token from Apple Sign-In' }
          },
          required: ['webAuthToken']
        }
      },
  
      // Assess Realm Tools (realmId 1)
      {
        name: 'assess_create_task',
        description: 'Create a new task in Assess realm (content editing, no contexts/dates).',
        inputSchema: {
          type: 'object',
          properties: {
            taskName: { type: 'string', description: 'Task name/description (max 1000 chars)' },
            startDate: { type: 'string', format: 'date-time', description: 'Optional start date (ISO format)' },
            taskPriority: { type: 'integer', minimum: 1, maximum: 5, description: 'Optional task priority (1-5, default 3)'},
            projectRecordName: { type: 'string', description: 'Optional recordName of the parent project.' },
            collectionRecordName: { type: 'string', description: 'Optional recordName of the parent collection.' }
          },
          required: ['taskName']
        }
      },
      {
        name: 'assess_edit_task',
        description: 'Edit task content in Assess realm (taskName, priority).',
        inputSchema: {
          type: 'object',
          properties: {
            taskRecordName: { type: 'string', description: 'Record name of the task to edit' },
            taskName: { type: 'string', description: 'Updated task name/description' },
            taskPriority: { type: 'integer', minimum: 1, maximum: 5, description: 'Updated task priority (1-5)'},
          },
          required: ['taskRecordName']
        }
      },
      {
        name: 'assess_create_project',
        description: 'Create a new project in Assess realm.',
        inputSchema: {
          type: 'object',
          properties: {
            projectName: { type: 'string', description: 'Project name/description (max 1500 chars)' },
            startDate: { type: 'string', format: 'date-time', description: 'Optional start date (ISO format)' },
            collectionRecordName: { type: 'string', description: 'Optional recordName of the parent collection.' }
          },
          required: ['projectName']
        }
      },
      {
        name: 'assess_create_idea',
        description: 'Capture a new idea (always starts in Assess realm).',
        inputSchema: {
          type: 'object',
          properties: {
            ideaName: { type: 'string', description: 'Idea name/details (max 1500 chars)' },
            collectionRecordName: { type: 'string', description: 'Optional recordName of the parent collection.' }
          },
          required: ['ideaName']
        }
      },
      {
        name: 'assess_create_collection',
        description: 'Create a new collection in Assess realm.',
        inputSchema: {
          type: 'object',
          properties: {
            collectionName: { type: 'string', description: 'Collection name' }
          },
          required: ['collectionName']
        }
      },
      {
        name: 'assess_create_context',
        description: 'Create a new context in Assess realm.',
        inputSchema: {
          type: 'object',
          properties: {
            contextName: { type: 'string', description: 'Context name (max 30 chars)' }
          },
          required: ['contextName']
        }
      },
      {
        name: 'assess_edit_project',
        description: 'Edit project content in Assess realm.',
        inputSchema: {
          type: 'object',
          properties: {
            projectRecordName: { type: 'string', description: 'Record name of the project to edit' },
            projectName: { type: 'string', description: 'Updated project name' }
          },
          required: ['projectRecordName']
        }
      },
      {
        name: 'assess_edit_idea',
        description: 'Edit idea content in Assess realm.',
        inputSchema: {
          type: 'object',
          properties: {
            ideaRecordName: { type: 'string', description: 'Record name of the idea to edit' },
            ideaName: { type: 'string', description: 'Updated idea name' }
          },
          required: ['ideaRecordName']
        }
      },
      {
        name: 'assess_add_task_to_project',
        description: 'Add an existing task to a project in Assess realm.',
        inputSchema: {
          type: 'object',
          properties: {
            taskRecordName: { type: 'string', description: 'Record name of the task' },
            projectRecordName: { type: 'string', description: 'Record name of the project' }
          },
          required: ['taskRecordName', 'projectRecordName']
        }
      },
      {
        name: 'assess_add_task_to_idea',
        description: 'Add an existing task to an idea in Assess realm.',
        inputSchema: {
          type: 'object',
          properties: {
            taskRecordName: { type: 'string', description: 'Record name of the task' },
            ideaRecordName: { type: 'string', description: 'Record name of the idea' }
          },
          required: ['taskRecordName', 'ideaRecordName']
        }
      },
      {
        name: 'assess_remove_task_from_project',
        description: 'Remove a task from a project in Assess realm.',
        inputSchema: {
          type: 'object',
          properties: {
            taskRecordName: { type: 'string', description: 'Record name of the task' },
            projectRecordName: { type: 'string', description: 'Record name of the project' }
          },
          required: ['taskRecordName', 'projectRecordName']
        }
      },
      {
        name: 'assess_remove_task_from_idea',
        description: 'Remove a task from an idea in Assess realm.',
        inputSchema: {
          type: 'object',
          properties: {
            taskRecordName: { type: 'string', description: 'Record name of the task' },
            ideaRecordName: { type: 'string', description: 'Record name of the idea' }
          },
          required: ['taskRecordName', 'ideaRecordName']
        }
      },
      {
        name: 'assess_archive_task_to_collection',
        description: 'Archive a task to a collection.',
        inputSchema: {
          type: 'object',
          properties: {
            taskRecordName: { type: 'string', description: 'Record name of the task' },
            collectionRecordName: { type: 'string', description: 'Record name of the collection' }
          },
          required: ['taskRecordName', 'collectionRecordName']
        }
      },
      {
        name: 'assess_archive_project_to_collection',
        description: 'Archive a project to a collection.',
        inputSchema: {
          type: 'object',
          properties: {
            projectRecordName: { type: 'string', description: 'Record name of the project' },
            collectionRecordName: { type: 'string', description: 'Record name of the collection' }
          },
          required: ['projectRecordName', 'collectionRecordName']
        }
      },
  
      // Decide Realm Tools (realmId 2)
      {
        name: 'decide_assign_context',
        description: 'Assign contexts to tasks/projects in Decide realm.',
        inputSchema: {
          type: 'object',
          properties: {
            itemRecordName: { type: 'string', description: 'Record name of the task or project' },
            itemType: { type: 'string', enum: ['Task', 'Project'], description: 'Type of item (Task or Project)' },
            contextRecordName: { type: 'string', description: 'Record name of the context to assign' }
          },
          required: ['itemRecordName', 'itemType', 'contextRecordName']
        }
      },
      {
        name: 'decide_set_project_interval',
        description: 'Set project interval (start date and end date) in Decide realm.',
        inputSchema: {
          type: 'object',
          properties: {
            projectRecordName: { type: 'string', description: 'Record name of the project' },
            startDate: { type: 'string', format: 'date-time', description: 'Start date in ISO format' },
            endDate: { type: 'string', format: 'date-time', description: 'End date in ISO format' }
          },
          required: ['projectRecordName', 'startDate', 'endDate']
        }
      },
      {
        name: 'decide_set_task_due_date',
        description: 'Set due date for a task in Decide realm.',
        inputSchema: {
          type: 'object',
          properties: {
            taskRecordName: { type: 'string', description: 'Record name of the task' },
            endDate: { type: 'string', format: 'date-time', description: 'Due date in ISO format' }
          },
          required: ['taskRecordName', 'endDate']
        }
      },
      {
        name: 'decide_set_task_alert',
        description: 'Set task alerts in Decide realm.',
        inputSchema: {
          type: 'object',
          properties: {
            taskRecordName: { type: 'string', description: 'Task record name' },
            alertDateTime: { type: 'string', format: 'date-time', description: 'Alert date and time in ISO format for localNotification' }
          },
          required: ['taskRecordName', 'alertDateTime']
        }
      },
      {
        name: 'decide_move_task_to_do',
        description: 'Move task to Do realm from Decide realm.',
        inputSchema: {
          type: 'object',
          properties: {
            taskRecordName: { type: 'string', description: 'Task record name' }
          },
          required: ['taskRecordName']
        }
      },
      {
        name: 'decide_move_task_to_assess_from_decide',
        description: 'Move task to Assess realm from Decide realm.',
        inputSchema: {
          type: 'object',
          properties: {
            taskRecordName: { type: 'string', description: 'Task record name' }
          },
          required: ['taskRecordName']
        }
      },
      {
        name: 'decide_move_project_to_do',
        description: 'Move project to Do realm from Decide realm.',
        inputSchema: {
          type: 'object',
          properties: {
            projectRecordName: { type: 'string', description: 'Project record name' }
          },
          required: ['projectRecordName']
        }
      },
      {
        name: 'decide_move_project_to_assess_from_decide',
        description: 'Move project to Assess realm from Decide realm.',
        inputSchema: {
          type: 'object',
          properties: {
            projectRecordName: { type: 'string', description: 'Project record name' }
          },
          required: ['projectRecordName']
        }
      },
  
      // Do Realm Tools (realmId 3)
      {
        name: 'do_mark_task_as_done',
        description: 'Mark tasks as completed in Do realm.',
        inputSchema: {
          type: 'object',
          properties: {
            taskRecordName: { type: 'string', description: 'Task record name' }
          },
          required: ['taskRecordName']
        }
      },
      {
        name: 'do_mark_project_as_done',
        description: 'Mark projects as completed in Do realm.',
        inputSchema: {
          type: 'object',
          properties: {
            projectRecordName: { type: 'string', description: 'Project record name' }
          },
          required: ['projectRecordName']
        }
      },
  
      // General Query Tools
      {
        name: 'get_tasks_by_realm',
        description: 'Filter tasks by realm.',
        inputSchema: {
          type: 'object',
          properties: {
            realm: { type: 'string', enum: ['assess', 'decide', 'do'], description: 'Realm to query (maps to realmId 1, 2, or 3)' }
          },
          required: ['realm']
        }
      },
      {
        name: 'get_projects_by_realm',
        description: 'Filter projects by realm.',
        inputSchema: {
          type: 'object',
          properties: {
            realm: { type: 'string', enum: ['assess', 'decide', 'do'], description: 'Realm to query (maps to realmId 1, 2, or 3)' }
          },
          required: ['realm']
        }
      },
      {
        name: 'get_ideas',
        description: 'Get all ideas.',
        inputSchema: { type: 'object', properties: {} }
      },
      {
        name: 'moveToRealm',
        description: 'Move a task or project to a specific realm.',
        inputSchema: {
          type: 'object',
          properties: {
            itemRecordName: { type: 'string', description: 'Record name of the task or project to move' },
            itemType: { type: 'string', enum: ['Task', 'Project'], description: 'Type of item to move' },
            realmId: { type: 'string', enum: ['assess', 'decide', 'do'], description: 'Target realm (assess=1, decide=2, do=3)' }
          },
          required: ['itemRecordName', 'itemType', 'realmId']
        }
      },
      {
        name: 'get_collections',
        description: 'Get all collections.',
        inputSchema: { type: 'object', properties: {} }
      },
      {
        name: 'get_tasks_by_context',
        description: 'Filter by context.',
        inputSchema: {
          type: 'object',
          properties: {
            contextRecordName: { type: 'string', description: 'Record name of the context to filter by' }
          },
          required: ['contextRecordName']
        }
      },
      {
        name: 'get_stalled_items_in_decide',
        description: 'Find stalled items (tasks + projects) in Decide realm.',
        inputSchema: { type: 'object', properties: {} }
      },
      {
        name: 'get_undecided_items_in_decide',
        description: 'Find undecided items (tasks + projects) in Decide realm.',
        inputSchema: { type: 'object', properties: {} }
      },
      {
        name: 'get_ready_items_in_decide',
        description: 'Find ready to do items (tasks + projects) in Decide realm.',
        inputSchema: { type: 'object', properties: {} }
      },
      {
        name: 'get_tasks_today_in_do',
        description: 'Find tasks due today in Do realm.',
        inputSchema: { type: 'object', properties: {} }
      },
      {
        name: 'get_tasks_tomorrow_in_do',
        description: 'Find tasks due tomorrow in Do realm.',
        inputSchema: { type: 'object', properties: {} }
      },
      {
        name: 'get_tasks_soon_in_do',
        description: 'Find tasks due soon in Do realm.',
        inputSchema: { type: 'object', properties: {} }
      },
      {
        name: 'get_tasks_overdue_in_do',
        description: 'Find tasks overdue in Do realm.',
        inputSchema: { type: 'object', properties: {} }
      }
    ] as Tool[]