Plane MCP Server

Instructions

Implementation Reference

• src/tools/issues.ts:210-224 (handler)

  The async handler function that executes the tool by sending a PATCH request to update the issue via the Plane API.

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

• src/tools/issues.ts:205-209 (schema)

  Input schema/validation for the update_issue tool parameters.

  {
    project_id: z.string().describe("The uuid identifier of the project containing the issue"),
    issue_id: z.string().describe("The uuid identifier of the issue to update"),
    issue_data: IssueSchema.partial().describe("The fields to update on the issue"),
  },

• src/tools/issues.ts:202-225 (registration)

  Registration of the 'update_issue' tool using McpServer.tool() method inside registerIssueTools function.

  server.tool(
    "update_issue",
    "Update an issue. This requests project_id and issue_id as uuid parameters. If you have a readable identifier, you can use the get_issue_using_readable_identifier tool to get the issue_id and project_id",
    {
      project_id: z.string().describe("The uuid identifier of the project containing the issue"),
      issue_id: z.string().describe("The uuid identifier of the issue to update"),
      issue_data: IssueSchema.partial().describe("The fields to update on the issue"),
    },
    async ({ project_id, issue_id, issue_data }) => {
      const response = await makePlaneRequest(
        "PATCH",
        `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/issues/${issue_id}/`,
        issue_data
      );
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(response, null, 2),
          },
        ],
      };
    }
  );

• src/schemas.ts:38-69 (schema)

  Zod schema for Issue object, referenced as IssueSchema and used in partial form for update_issue input.

  export const Issue = z.object({
    archived_at: z.string().date().optional(),
    assignees: z.array(z.string().uuid()).optional(),
    completed_at: z.string().datetime({ offset: true }).optional(),
    created_at: z.string().datetime({ offset: true }).readonly(),
    created_by: z.string().uuid().optional(),
    deleted_at: z.string().datetime({ offset: true }).optional(),
    description_binary: z.string().readonly(),
    description_html: z.string().optional(),
    estimate_point: z.string().uuid().optional(),
    external_id: z.string().max(255).optional(),
    external_source: z.string().max(255).optional(),
    id: z.string().uuid().readonly(),
    is_draft: z.boolean().optional(),
    labels: z.array(z.string().uuid()).optional(),
    name: z.string().max(255),
    parent: z.string().uuid().optional(),
    point: z.number().int().gte(0).lte(12).optional(),
    priority: z.any().optional(),
    project: z.string().uuid().readonly(),
    sequence_id: z.number().int().gte(-2147483648).lte(2147483647).optional(),
    sort_order: z.number().optional(),
    start_date: z.string().date().optional(),
    state: z.string().uuid().optional(),
    target_date: z.string().date().optional(),
    type: z.string().uuid().optional(),
    type_id: z.string().uuid().optional(),
    updated_at: z.string().datetime({ offset: true }).readonly(),
    updated_by: z.string().uuid().readonly(),
    workspace: z.string().uuid().readonly(),
  });
  export type Issue = z.infer<typeof Issue>;

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

  High-level registration call to registerIssueTools(server), which includes the update_issue tool.

  registerIssueTools(server);