Zoho Projects MCP Server

Instructions

Implementation Reference

• src/index.ts:706-718 (handler)

  The handler function that implements the core logic for the 'list_tasks' tool. It builds the Zoho Projects API endpoint depending on whether a project ID is provided (project-specific or portal-wide tasks) and fetches the data using the shared makeRequest method, returning formatted JSON.

  private async listTasks(
    projectId?: string,
    page: number = 1,
    perPage: number = 10
  ) {
    const endpoint = projectId
      ? `/portal/${this.config.portalId}/projects/${projectId}/tasks?page=${page}&per_page=${perPage}`
      : `/portal/${this.config.portalId}/tasks?page=${page}&per_page=${perPage}`;
    const data = await this.makeRequest(endpoint);
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }

• src/index.ts:285-303 (schema)

  The tool schema definition including name, description, and input schema for parameters (project_id optional, pagination). This is returned by the ListTools handler.

  {
    name: "list_tasks",
    description: "List tasks from a project or portal",
    inputSchema: {
      type: "object",
      properties: {
        project_id: {
          type: "string",
          description: "Project ID (optional for portal-level)",
        },
        page: { type: "number", description: "Page number", default: 1 },
        per_page: {
          type: "number",
          description: "Items per page",
          default: 10,
        },
      },
    },
  },

• src/index.ts:572-573 (registration)

  Registration/dispatch point in the CallToolRequestSchema switch statement that routes calls to the listTasks handler.

  case "list_tasks":
    return await this.listTasks(params.project_id, params.page, params.per_page);

• src/http-server.ts:709-721 (handler)

  Identical handler function in the HTTP server implementation for the 'list_tasks' tool.

  private async listTasks(
    projectId?: string,
    page: number = 1,
    perPage: number = 10
  ) {
    const endpoint = projectId
      ? `/portal/${this.config.portalId}/projects/${projectId}/tasks?page=${page}&per_page=${perPage}`
      : `/portal/${this.config.portalId}/tasks?page=${page}&per_page=${perPage}`;
    const data = await this.makeRequest(endpoint);
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }

• src/http-server.ts:288-306 (schema)

  Identical tool schema in the HTTP server version.

  {
    name: "list_tasks",
    description: "List tasks from a project or portal",
    inputSchema: {
      type: "object",
      properties: {
        project_id: {
          type: "string",
          description: "Project ID (optional for portal-level)",
        },
        page: { type: "number", description: "Page number", default: 1 },
        per_page: {
          type: "number",
          description: "Items per page",
          default: 10,
        },
      },
    },
  },