Plane MCP Server

Instructions

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);