update_issue
Modify issue details in Plane MCP Server by providing project_id, issue_id, and updated issue_data, including attributes like assignees, labels, and target dates.
Instructions
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
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issue_data | Yes | The fields to update on the issue | |
| issue_id | Yes | The uuid identifier of the issue to update | |
| project_id | Yes | The uuid identifier of the project containing the issue |
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);