Kanban MCP Server

Instructions

Implementation Reference

• src/utils/mongoose.ts:74-89 (handler)

  Core handler logic for moving a task: finds the task by ID, updates its status, and saves to database.

  export async function moveTask(
    taskId: string,
    newStatus: "todo" | "inProgress" | "done"
  ) {
    try {
      const task = await Task.findById(taskId);
      if (!task) {
        throw new Error("Task not found");
      }
  
      task.taskStatus = newStatus;
      await task.save();
    } catch {
      throw new Error("Failed to move task");
    }
  }

• src/index.ts:79-82 (schema)

  Zod input schema for the move-task tool parameters.

  {
    task_id: z.string(),
    new_status: z.enum(["todo", "inProgress", "done"]),
  },

• src/index.ts:76-111 (registration)

  Registration of the 'move-task' tool with MCP server, including description, schema, hints, and wrapper handler.

  server.tool(
    "move-task",
    "move a task to a different status",
    {
      task_id: z.string(),
      new_status: z.enum(["todo", "inProgress", "done"]),
    },
    {
      title: "move a task to a different status",
      readonlyHint: false,
      destructiveHint: false,
      idempotentHint: false,
      openWorldHint: true,
    },
    async (params) => {
      try {
        await mongooseUtils.moveTask(params.task_id, params.new_status);
        return {
          content: [
            {
              type: "text",
              text: `Task "${params.task_id}" moved to "${params.new_status}" successfully!`,
            },
          ],
        };
      } catch {
        return {
          content: [
            {
              type: "text",
              text: `Failed to move task "${params.task_id}" to "${params.new_status}".`,
            },
          ],
        };
      }
    }

• src/utils/Task.js:6-10 (schema)

  Mongoose model schema defining the taskStatus field with matching enum values used by the tool.

  taskStatus: {
    type: String,
    enum: ["todo", "inProgress", "done"],
    default: "todo",
  },