delete_cycle_issue

Remove a specific issue from a project cycle using the Plane MCP Server. Requires project, cycle, and issue IDs to execute the action effectively.

Instructions

Remove an issue from a cycle

Input Schema

TableJSON Schema

Name	Required	Description
`cycle_id`	Yes	The uuid identifier of the cycle containing the issue
`issue_id`	Yes	The uuid identifier of the issue to remove from the cycle
`project_id`	Yes	The uuid identifier of the project containing the cycle

Implementation Reference

src/tools/cycle-issues.ts:63-76 (handler)

Handler function that sends a DELETE request to the Plane API to remove the specified issue from the cycle and returns a success confirmation.

async ({ project_id, cycle_id, issue_id }) => {
  await makePlaneRequest(
    "DELETE",
    `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/cycles/${cycle_id}/cycle-issues/${issue_id}/`
  );
  return {
    content: [
      {
        type: "text",
        text: "Issue removed from cycle successfully",
      },
    ],
  };
}

src/tools/cycle-issues.ts:58-62 (schema)

Zod input schema defining the required parameters: project_id, cycle_id, and issue_id.

{
  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 containing the issue"),
  issue_id: z.string().describe("The uuid identifier of the issue to remove from the cycle"),
},

src/tools/cycle-issues.ts:55-77 (registration)

Full registration of the 'delete_cycle_issue' tool on the MCP server, including description, input schema, and inline handler function.

server.tool(
  "delete_cycle_issue",
  "Remove an issue from 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 containing the issue"),
    issue_id: z.string().describe("The uuid identifier of the issue to remove from the cycle"),
  },
  async ({ project_id, cycle_id, issue_id }) => {
    await makePlaneRequest(
      "DELETE",
      `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/cycles/${cycle_id}/cycle-issues/${issue_id}/`
    );
    return {
      content: [
        {
          type: "text",
          text: "Issue removed from cycle successfully",
        },
      ],
    };
  }
);

src/common/request-helper.ts:2-36 (helper)

Utility function makePlaneRequest used in the handler to perform HTTP requests to the Plane API with authentication.

export async function makePlaneRequest<T>(method: string, path: string, body: any = null): Promise<T> {
  const hostUrl = process.env.PLANE_API_HOST_URL || "https://api.plane.so/";
  const host = hostUrl.endsWith("/") ? hostUrl : `${hostUrl}/`;
  const url = `${host}api/v1/${path}`;
  const headers: Record<string, string> = {
    "X-API-Key": process.env.PLANE_API_KEY || "",
  };

  // Only add Content-Type for non-GET requests
  if (method.toUpperCase() !== "GET") {
    headers["Content-Type"] = "application/json";
  }

  try {
    const config: AxiosRequestConfig = {
      url,
      method,
      headers,
    };

    // Only include body for non-GET requests
    if (method.toUpperCase() !== "GET" && body !== null) {
      config.data = body;
    }

    const response = await axios(config);
    return response.data;
  } catch (error) {
    if (axios.isAxiosError(error)) {
      throw new Error(`Request failed: ${error.message}`);
    }
    throw error;
  }
}

Plane MCP Server