Enhanced Todoist MCP Server Extended

Instructions

Implementation Reference

• src/index.ts:1622-1646 (handler)

  Executes the tool logic: validates args with isMoveTaskArgs, constructs moveArgs, calls todoistClient.moveTasks([taskId], moveArgs), fetches updated task with getTask, formats and returns success response or error.

  if (name === "todoist_move_task") {
    if (!isMoveTaskArgs(args)) {
      return { content: [{ type: "text", text: "Invalid arguments for move_task. Provide taskId and exactly one of: projectId, sectionId, or parentId (must be a non-empty string)." }], isError: true };
    }
    try {
      const moveArgs: { projectId?: string; sectionId?: string; parentId?: string } = {};
      if (args.projectId) moveArgs.projectId = args.projectId;
      else if (args.sectionId) moveArgs.sectionId = args.sectionId;
      else if (args.parentId) moveArgs.parentId = args.parentId;
  
      // Use moveTasks from SDK v4+
      await todoistClient.moveTasks([args.taskId], moveArgs as any); // Cast to any for MoveTaskArgs as it expects RequireExactlyOne
      
      const movedTask = await todoistClient.getTask(args.taskId);
      return {
        content: [{
          type: "text",
          text: `Task ${args.taskId} moved successfully.\nNew details:\n${formatTask(movedTask)}`
        }],
        isError: false
      };
    } catch (error: any) {
      return { content: [{ type: "text", text: `Error moving task: ${error.message}` }], isError: true };
    }
  }

• src/index.ts:228-256 (schema)

  JSON schema defining the input parameters for the todoist_move_task tool: taskId (required), and exactly one optional destination: projectId, sectionId, or parentId.

  const MOVE_TASK_TOOL: Tool = {
    name: "todoist_move_task",
    description: "Move a single task (and its subtasks, if any) to a different project, section, or make it a subtask of another task. Provide the taskId and exactly one of: projectId, sectionId, or parentId.",
    inputSchema: {
      type: "object",
      properties: {
        taskId: {
          type: "string",
          description: "The ID of the task to move."
        },
        projectId: {
          type: "string",
          description: "The ID of the destination project. (Optional, use only one of projectId, sectionId, parentId)"
        },
        sectionId: {
          type: "string",
          description: "The ID of the destination section. (Optional, use only one of projectId, sectionId, parentId)"
        },
        parentId: {
          type: "string",
          description: "The ID of the parent task to move this task under. (Optional, use only one of projectId, sectionId, parentId)"
        }
      },
      required: ["taskId"]
      // Note: Validation for providing exactly one of projectId, sectionId, or parentId
      // is handled in the isMoveTaskArgs type guard and the tool handler.
      // A more complex JSON schema with oneOf could enforce this, but client support varies.
    }
  };

• src/index.ts:1083-1121 (registration)

  Registers the todoist_move_task tool (as MOVE_TASK_TOOL) in the list of available tools returned by the ListToolsRequest handler.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: [
      // Task tools
      CREATE_TASK_TOOL,
      QUICK_ADD_TASK_TOOL,
      GET_TASKS_TOOL,
      GET_TASK_TOOL,
      UPDATE_TASK_TOOL,
      DELETE_TASK_TOOL,
      COMPLETE_TASK_TOOL,
      REOPEN_TASK_TOOL,
      SEARCH_TASKS_TOOL,
      MOVE_TASK_TOOL,
      BULK_MOVE_TASKS_TOOL,
      // Project tools
      GET_PROJECTS_TOOL,
      GET_PROJECT_TOOL,
      CREATE_PROJECT_TOOL,
      UPDATE_PROJECT_TOOL,
      DELETE_PROJECT_TOOL,
      // Section tools
      GET_SECTIONS_TOOL,
      CREATE_SECTION_TOOL,
      UPDATE_SECTION_TOOL,
      DELETE_SECTION_TOOL,
      // Label tools
      CREATE_LABEL_TOOL,
      GET_LABEL_TOOL,
      GET_LABELS_TOOL,
      UPDATE_LABEL_TOOL,
      DELETE_LABEL_TOOL,
      // Comment tools
      CREATE_COMMENT_TOOL,
      GET_COMMENT_TOOL,
      GET_COMMENTS_TOOL,
      UPDATE_COMMENT_TOOL,
      DELETE_COMMENT_TOOL,
    ],
  }));

• src/index.ts:926-942 (helper)

  Type guard helper that validates the input arguments for todoist_move_task, ensuring taskId is a string and exactly one non-empty destination (projectId, sectionId, or parentId) is provided.

  function isMoveTaskArgs(args: unknown): args is {
    taskId: string;
    projectId?: string;
    sectionId?: string;
    parentId?: string;
  } {
    if (typeof args !== 'object' || args === null || !('taskId' in args) || typeof (args as any).taskId !== 'string') {
      return false;
    }
    const { projectId, sectionId, parentId } = args as any;
    const destinations = [projectId, sectionId, parentId];
    const providedDestinations = destinations.filter(dest => dest !== undefined && dest !== null && String(dest).trim() !== '');
    
    // Exactly one destination must be provided and be a non-empty string
    return providedDestinations.length === 1 && 
           providedDestinations.every(dest => typeof dest === 'string');
  }