TaskWarrior MCP Server

Instructions

Implementation Reference

• index.ts:141-150 (handler)

  Handler for the 'mark_task_done' tool. Parses the input arguments using markTaskDoneRequest schema, executes the TaskWarrior command 'task <identifier> done' using execSync, and returns the command output as text content.

  case "mark_task_done": {
    const parsed = markTaskDoneRequest.safeParse(args);
    if (!parsed.success) {
      throw new Error(`Invalid arguments for mark_task_done: ${parsed.error}`);
    }
    const content = execSync(`task ${parsed.data.identifier} done`, { maxBuffer: 1024 * 1024 * 10 }).toString().trim();
    return {
      content: [{ type: "text", text: content }],
    };
  }

• index.ts:51-53 (schema)

  Zod input schema for 'mark_task_done' tool, requiring an 'identifier' string.

  const markTaskDoneRequest = z.object({
    identifier: z.string(),
  });

• index.ts:101-105 (registration)

  Registration of the 'mark_task_done' tool in the ListTools response, including name, description, and input schema.

  {
    name: "mark_task_done", 
    description: "Mark a task as done (completed)",
    inputSchema: zodToJsonSchema(markTaskDoneRequest) as ToolInput,
  },