list_cycle_issues

Retrieve all issues associated with a specific cycle in a project by providing the project and cycle identifiers through the Plane MCP Server. Simplifies issue tracking and management.

Instructions

Get all issues for a specific cycle

Input Schema

TableJSON Schema

Name	Required	Description	Default
`cycle_id`	Yes	The uuid identifier of the cycle to get issues for
`project_id`	Yes	The uuid identifier of the project containing the cycle

Implementation Reference

src/tools/cycle-issues.ts:14-27 (handler)

The handler function that implements the core logic of the 'list_cycle_issues' tool: fetches issues for a given project and cycle via the Plane API and returns the response as formatted text.

async ({ project_id, cycle_id }) => {
  const response = await makePlaneRequest(
    "GET",
    `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/cycles/${cycle_id}/cycle-issues/`
  );
  return {
    content: [
      {
        type: "text",
        text: JSON.stringify(response, null, 2),
      },
    ],
  };
}

src/tools/cycle-issues.ts:10-13 (schema)

Zod input schema defining required parameters: project_id and cycle_id as UUID strings.

{
  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 get issues for"),
},

src/tools/cycle-issues.ts:7-28 (registration)

Direct registration of the 'list_cycle_issues' tool using server.tool(), including name, description, schema, and handler.

server.tool(
  "list_cycle_issues",
  "Get all issues for a specific 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 get issues for"),
  },
  async ({ project_id, cycle_id }) => {
    const response = await makePlaneRequest(
      "GET",
      `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/cycles/${cycle_id}/cycle-issues/`
    );
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(response, null, 2),
        },
      ],
    };
  }
);

src/tools/index.ts:22-22 (registration)
Call to registerCycleIssueTools within the central registerTools function, which registers multiple tools including list_cycle_issues.
```
registerCycleIssueTools(server);
```

src/tools/cycle-issues.ts:6-78 (helper)

Wrapper function that registers cycle issue related tools, including list_cycle_issues.

export const registerCycleIssueTools = (server: McpServer) => {
  server.tool(
    "list_cycle_issues",
    "Get all issues for a specific 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 get issues for"),
    },
    async ({ project_id, cycle_id }) => {
      const response = await makePlaneRequest(
        "GET",
        `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/cycles/${cycle_id}/cycle-issues/`
      );
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(response, null, 2),
          },
        ],
      };
    }
  );

  server.tool(
    "add_cycle_issues",
    "Add issues to 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 add issues to"),
      issues: z.array(z.string()).describe("Array of issue UUIDs to add to the cycle"),
    },
    async ({ project_id, cycle_id, issues }) => {
      const response = await makePlaneRequest(
        "POST",
        `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/cycles/${cycle_id}/cycle-issues/`,
        { issues }
      );
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(response, null, 2),
          },
        ],
      };
    }
  );

  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",
          },
        ],
      };
    }
  );
};

Plane MCP Server