Zoho Projects MCP Server

Instructions

Implementation Reference

• src/http-server.ts:805-819 (handler)

  Core handler function that destructures params, calls makeRequest to POST new issue data to Zoho Projects API endpoint, and returns formatted success response with created issue details.

  private async createIssue(params: any) {
    const { project_id, ...issueData } = params;
    const data = await this.makeRequest(
      `/portal/${this.config.portalId}/projects/${project_id}/issues`,
      "POST",
      issueData
    );
    return {
      content: [
        {
          type: "text",
          text: `Issue created successfully:\n${JSON.stringify(data, null, 2)}`,
        },
      ],
    };

• src/index.ts:802-816 (handler)

  Core handler function that destructures params, calls makeRequest to POST new issue data to Zoho Projects API endpoint, and returns formatted success response with created issue details.

  private async createIssue(params: any) {
    const { project_id, ...issueData } = params;
    const data = await this.makeRequest(
      `/portal/${this.config.portalId}/projects/${project_id}/issues`,
      "POST",
      issueData
    );
    return {
      content: [
        {
          type: "text",
          text: `Issue created successfully:\n${JSON.stringify(data, null, 2)}`,
        },
      ],
    };

• src/http-server.ts:418-432 (schema)

  Input schema defining parameters for create_issue tool: project_id and title required, optional description, severity (enum), due_date.

  inputSchema: {
    type: "object",
    properties: {
      project_id: { type: "string", description: "Project ID" },
      title: { type: "string", description: "Issue title" },
      description: { type: "string", description: "Issue description" },
      severity: {
        type: "string",
        description: "Issue severity",
        enum: ["minor", "major", "critical"],
      },
      due_date: { type: "string", description: "Due date (YYYY-MM-DD)" },
    },
    required: ["project_id", "title"],
  },

• src/http-server.ts:415-433 (registration)

  Registration of create_issue tool in the tools list returned by listTools, specifying name, description, and input schema.

  {
    name: "create_issue",
    description: "Create a new issue",
    inputSchema: {
      type: "object",
      properties: {
        project_id: { type: "string", description: "Project ID" },
        title: { type: "string", description: "Issue title" },
        description: { type: "string", description: "Issue description" },
        severity: {
          type: "string",
          description: "Issue severity",
          enum: ["minor", "major", "critical"],
        },
        due_date: { type: "string", description: "Due date (YYYY-MM-DD)" },
      },
      required: ["project_id", "title"],
    },
  },

• src/http-server.ts:591-592 (registration)

  Dispatch case in CallToolRequestHandler switch statement that routes 'create_issue' calls to the handler method.

  case "create_issue":
    return await this.createIssue(params);