Enhanced Todoist MCP Server Extended

Instructions

Implementation Reference

• src/index.ts:1157-1174 (handler)

  Executes the tool by validating arguments with isQuickAddArgs and calling todoistClient.quickAddTask with the provided text, optional note, and reminder.

  if (name === "todoist_quick_add_task") {
    if (!isQuickAddArgs(args)) {
      throw new Error("Invalid arguments for todoist_quick_add_task");
    }
    
    const quickAddData: any = { text: args.text };
    if (args.note) quickAddData.note = args.note;
    if (args.reminder) quickAddData.reminder = args.reminder;
  
    const result = await todoistClient.quickAddTask(quickAddData);
    return {
      content: [{ 
        type: "text", 
        text: `Task created via Quick Add:\n${JSON.stringify(result, null, 2)}` 
      }],
      isError: false,
    };
  }

• src/index.ts:68-89 (schema)

  Tool definition including name, description, and JSON input schema specifying required 'text' and optional 'note' and 'reminder'.

  const QUICK_ADD_TASK_TOOL: Tool = {
    name: "todoist_quick_add_task",
    description: "Create a task using Todoist's Quick Add feature with natural language parsing",
    inputSchema: {
      type: "object",
      properties: {
        text: {
          type: "string",
          description: "Natural language text for quick task creation (e.g., 'Buy milk tomorrow at 2pm #shopping')"
        },
        note: {
          type: "string",
          description: "Additional note for the task (optional)"
        },
        reminder: {
          type: "string",
          description: "Reminder time (optional)"
        }
      },
      required: ["text"]
    }
  };

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

  Registers the tool by including QUICK_ADD_TASK_TOOL in the list returned by ListToolsRequestSchema 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:763-774 (helper)

  Type guard function used in the handler to validate input arguments for the todoist_quick_add_task tool.

  function isQuickAddArgs(args: unknown): args is {
    text: string;
    note?: string;
    reminder?: string;
  } {
    return (
      typeof args === "object" &&
      args !== null &&
      "text" in args &&
      typeof (args as { text: string }).text === "string"
    );
  }