Plane MCP Server

Instructions

Implementation Reference

• src/tools/cycles.ts:114-127 (handler)

  The asynchronous handler function that sends a DELETE request to the Plane API endpoint to delete the cycle identified by project_id and cycle_id, then returns a success message.

  async ({ project_id, cycle_id }) => {
    await makePlaneRequest(
      "DELETE",
      `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/cycles/${cycle_id}/`
    );
    return {
      content: [
        {
          type: "text",
          text: "Cycle deleted successfully",
        },
      ],
    };
  }

• src/tools/cycles.ts:110-113 (schema)

  Input schema using Zod for validating project_id and cycle_id parameters required by the delete_cycle tool.

  {
    project_id: z.string().describe("The uuid identifier of the project containing the cycle"),
    cycle_id: z.string().describe("The uuid identifier of the cycle to delete"),
  },

• src/tools/cycles.ts:107-128 (registration)

  Tool registration using server.tool() with name 'delete_cycle', description, input schema, and handler function.

  server.tool(
    "delete_cycle",
    "Delete a cycle",
    {
      project_id: z.string().describe("The uuid identifier of the project containing the cycle"),
      cycle_id: z.string().describe("The uuid identifier of the cycle to delete"),
    },
    async ({ project_id, cycle_id }) => {
      await makePlaneRequest(
        "DELETE",
        `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/cycles/${cycle_id}/`
      );
      return {
        content: [
          {
            type: "text",
            text: "Cycle deleted successfully",
          },
        ],
      };
    }
  );

• src/tools/index.ts:21-21 (registration)

  Higher-level registration call that invokes registerCycleTools, which includes the delete_cycle tool.

  registerCycleTools(server);