Zoho Projects MCP Server

Instructions

Implementation Reference

• src/index.ts:880-888 (handler)

  Core handler function for the 'list_users' MCP tool. Determines the Zoho Projects API endpoint based on optional project_id (portal-level if absent), fetches user data, and returns it as a MCP-formatted text content block with JSON stringification.

  private async listUsers(projectId?: string) {
    const endpoint = projectId
      ? `/portal/${this.config.portalId}/projects/${projectId}/users`
      : `/portal/${this.config.portalId}/users`;
    const data = await this.makeRequest(endpoint);
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }

• src/http-server.ts:883-891 (handler)

  Core handler function for the 'list_users' MCP tool (HTTP server variant). Determines the Zoho Projects API endpoint based on optional project_id (portal-level if absent), fetches user data, and returns it as a MCP-formatted text content block with JSON stringification.

  private async listUsers(projectId?: string) {
    const endpoint = projectId
      ? `/portal/${this.config.portalId}/projects/${projectId}/users`
      : `/portal/${this.config.portalId}/users`;
    const data = await this.makeRequest(endpoint);
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }

• src/index.ts:529-540 (registration)

  Tool registration in ListToolsRequestSchema response, defining name, description, and input schema for 'list_users'.

    name: "list_users",
    description: "List users in a portal or project",
    inputSchema: {
      type: "object",
      properties: {
        project_id: {
          type: "string",
          description: "Project ID (optional for portal-level)",
        },
      },
    },
  },

• src/http-server.ts:532-543 (registration)

  Tool registration in ListToolsRequestSchema response, defining name, description, and input schema for 'list_users' (HTTP server variant).

    name: "list_users",
    description: "List users in a portal or project",
    inputSchema: {
      type: "object",
      properties: {
        project_id: {
          type: "string",
          description: "Project ID (optional for portal-level)",
        },
      },
    },
  },

• src/index.ts:531-539 (schema)

  Input schema definition for the 'list_users' tool, specifying optional project_id parameter.

  inputSchema: {
    type: "object",
    properties: {
      project_id: {
        type: "string",
        description: "Project ID (optional for portal-level)",
      },
    },
  },