Plane MCP Server

Instructions

Implementation Reference

• src/tools/metadata.ts:255-269 (handler)

  The async handler function for the list_labels tool, which makes a GET request to the Plane API to fetch all labels for the specified project and returns the JSON response formatted as text content.

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

• src/tools/metadata.ts:252-254 (schema)

  Input schema definition for the list_labels tool using Zod, specifying the required project_id parameter.

  {
    project_id: z.string().describe("The uuid identifier of the project to get labels for"),
  },

• src/tools/metadata.ts:249-269 (registration)

  Registration of the list_labels MCP tool within the registerMetadataTools function using server.tool(), including name, description, input schema, and inline handler implementation.

  server.tool(
    "list_labels",
    "Get all labels for a specific project",
    {
      project_id: z.string().describe("The uuid identifier of the project to get labels for"),
    },
    async ({ project_id }) => {
      const response = await makePlaneRequest(
        "GET",
        `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/labels/`
      );
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(response, null, 2),
          },
        ],
      };
    }
  );