create_issue
Generate and submit new issues within the Plane MCP Server. Provide a project UUID and relevant issue details, including name and HTML description, to create and track tasks or problems efficiently.
Instructions
Create an issue. This requests project_id as uuid parameter. If you have a readable identifier for project, you can use the get_projects tool to get the project_id from it
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issue_data | Yes | ||
| project_id | Yes | The uuid identifier of the project to create the issue for |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"issue_data": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date",
"type": "string"
},
"assignees": {
"items": {
"format": "uuid",
"type": "string"
},
"type": "array"
},
"completed_at": {
"format": "date-time",
"type": "string"
},
"created_at": {
"format": "date-time",
"type": "string"
},
"created_by": {
"format": "uuid",
"type": "string"
},
"deleted_at": {
"format": "date-time",
"type": "string"
},
"description_binary": {
"type": "string"
},
"description_html": {
"type": "string"
},
"estimate_point": {
"format": "uuid",
"type": "string"
},
"external_id": {
"maxLength": 255,
"type": "string"
},
"external_source": {
"maxLength": 255,
"type": "string"
},
"id": {
"format": "uuid",
"type": "string"
},
"is_draft": {
"type": "boolean"
},
"labels": {
"items": {
"format": "uuid",
"type": "string"
},
"type": "array"
},
"name": {
"maxLength": 255,
"type": "string"
},
"parent": {
"format": "uuid",
"type": "string"
},
"point": {
"maximum": 12,
"minimum": 0,
"type": "integer"
},
"priority": {},
"project": {
"format": "uuid",
"type": "string"
},
"sequence_id": {
"maximum": 2147483647,
"minimum": -2147483648,
"type": "integer"
},
"sort_order": {
"type": "number"
},
"start_date": {
"format": "date",
"type": "string"
},
"state": {
"format": "uuid",
"type": "string"
},
"target_date": {
"format": "date",
"type": "string"
},
"type": {
"format": "uuid",
"type": "string"
},
"type_id": {
"format": "uuid",
"type": "string"
},
"updated_at": {
"format": "date-time",
"type": "string"
},
"updated_by": {
"format": "uuid",
"type": "string"
},
"workspace": {
"format": "uuid",
"type": "string"
}
},
"required": [
"description_html",
"name"
],
"type": "object"
},
"project_id": {
"description": "The uuid identifier of the project to create the issue for",
"type": "string"
}
},
"required": [
"project_id",
"issue_data"
],
"type": "object"
}
Implementation Reference
- src/tools/issues.ts:175-200 (registration)Registers the 'create_issue' MCP tool with input schema (project_id and partial IssueSchema requiring name and description_html) and handler that POSTs to Plane API.server.tool( "create_issue", "Create an issue. This requests project_id as uuid parameter. If you have a readable identifier for project, you can use the get_projects tool to get the project_id from it", { project_id: z.string().describe("The uuid identifier of the project to create the issue for"), issue_data: IssueSchema.partial().required({ name: true, description_html: true, }), }, async ({ project_id, issue_data }) => { const response = await makePlaneRequest( "POST", `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/issues/`, issue_data ); return { content: [ { type: "text", text: JSON.stringify(response, null, 2), }, ], }; } );
- src/tools/issues.ts:185-200 (handler)Handler function executes the tool by sending a POST request to the Plane issues endpoint with the provided project_id and issue_data, returning the response as text content.async ({ project_id, issue_data }) => { const response = await makePlaneRequest( "POST", `workspaces/${process.env.PLANE_WORKSPACE_SLUG}/projects/${project_id}/issues/`, issue_data ); return { content: [ { type: "text", text: JSON.stringify(response, null, 2), }, ], }; } );
- src/schemas.ts:38-69 (schema)Zod schema definition for Issue type (imported as IssueSchema), used for validating issue_data input in create_issue tool.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)Higher-level registration calls registerIssueTools(server), which includes the create_issue tool.registerIssueTools(server);