Plane MCP Server

Instructions

Implementation Reference

• src/tools/metadata.ts:173-199 (registration)

  Registration of the 'create_state' MCP tool using server.tool(). Includes tool name, description, input schema (project_id and partial StateSchema requiring name, color, group), and inline asynchronous handler that sends a POST request to the Plane API to create the state and returns the JSON response as text content.

  server.tool(
    "create_state",
    "Create a new state in a project",
    {
      project_id: z.string().describe("The uuid identifier of the project to create the state in"),
      state_data: StateSchema.partial().required({
        name: true,
        color: true,
        group: true,
      }),
    },
    async ({ project_id, state_data }) => {
      const response = await makePlaneRequest(
        "POST",
        `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/states/`,
        state_data
      );
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(response, null, 2),
          },
        ],
      };
    }
  );

• src/schemas.ts:125-145 (schema)

  Zod schema definition for the State object (exported as StateSchema), used in the input schema for create_state tool to validate state_data.

  export const State = z.object({
    color: z.string().max(255),
    created_at: z.string().datetime({ offset: true }).readonly(),
    created_by: z.string().uuid().readonly(),
    default: z.boolean().optional(),
    deleted_at: z.string().datetime({ offset: true }).readonly(),
    description: z.string().optional(),
    external_id: z.string().max(255).optional(),
    external_source: z.string().max(255).optional(),
    group: z.any().optional(),
    id: z.string().uuid().readonly(),
    is_triage: z.boolean().optional(),
    name: z.string().max(255),
    project: z.string().uuid().readonly(),
    sequence: z.number().optional(),
    slug: z.string().regex(new RegExp("^[-a-zA-Z0-9_]+$")).max(100).optional(),
    updated_at: z.string().datetime({ offset: true }).readonly(),
    updated_by: z.string().uuid().readonly(),
    workspace: z.string().uuid().readonly(),
  });
  export type State = z.infer<typeof State>;