Plane MCP Server

Instructions

Implementation Reference

• src/index.ts:368-385 (handler)

  Handler for the 'get-issue' tool: validates project_id and issue_id arguments, calls Plane API to fetch the issue details, and returns the JSON response.

  case "get-issue": {
    if (
      !args ||
      typeof args.project_id !== "string" ||
      typeof args.issue_id !== "string"
    ) {
      throw new Error("Project ID and Issue ID are required");
    }
    const { project_id, issue_id } = args;
    const issue = await callPlaneAPI(
      `/projects/${project_id}/issues/${issue_id}/`,
      "GET"
    );
    return {
      content: [{ type: "text", text: JSON.stringify(issue, null, 2) }],
      isError: false,
    };
  }

• src/index.ts:127-144 (schema)

  Schema definition for the 'get-issue' tool, specifying required project_id and issue_id inputs.

  const GET_ISSUE_TOOL: Tool = {
    name: "get-issue",
    description: "Get detailed information about a specific issue",
    inputSchema: {
      type: "object",
      properties: {
        project_id: {
          type: "string",
          description: "ID of the project containing the issue",
        },
        issue_id: {
          type: "string",
          description: "ID of the issue to retrieve",
        },
      },
      required: ["project_id", "issue_id"],
    },
  };

• src/index.ts:262-271 (registration)

  Registration of the 'get-issue' tool in the listTools handler response, including it in the available tools list.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: [
      LIST_PROJECTS_TOOL,
      GET_PROJECT_TOOL,
      CREATE_ISSUE_TOOL,
      LIST_ISSUES_TOOL,
      GET_ISSUE_TOOL,
      UPDATE_ISSUE_TOOL,
    ],
  }));