N Lobby MCP Server

Instructions

Implementation Reference

• src/server.ts:261-292 (registration)

  Tool registration and input schema definition for get_calendar_events in the ListToolsRequestSchema handler.

  {
    name: "get_calendar_events",
    description: "Get calendar events with advanced options",
    inputSchema: {
      type: "object",
      properties: {
        calendar_type: {
          type: "string",
          enum: ["personal", "school"],
          description:
            "Type of calendar to retrieve (personal or school)",
          default: "personal",
        },
        from_date: {
          type: "string",
          description:
            "Start date in YYYY-MM-DD format (optional). If only from_date is provided, it will be treated as a single day.",
        },
        to_date: {
          type: "string",
          description:
            "End date in YYYY-MM-DD format (optional). Must be at least 1 day after from_date when both are provided.",
        },
        period: {
          type: "string",
          enum: ["today", "week", "month"],
          description:
            'Predefined period (optional, overrides from/to dates). Use "today" for single day queries.',
        },
      },
    },
  },

• src/server.ts:736-803 (handler)

  The core handler logic for executing the get_calendar_events tool. Parses arguments, determines calendar type and date range using helper methods on the API instance, fetches the schedule data, and formats the response.

  case "get_calendar_events":
    try {
      const { calendar_type, from_date, to_date, period } = args as {
        calendar_type?: string;
        from_date?: string;
        to_date?: string;
        period?: string;
      };
  
      // Determine calendar type
      const calendarType =
        calendar_type === "school"
          ? CalendarType.SCHOOL
          : CalendarType.PERSONAL;
  
      // Determine date range
      let dateRange;
      if (period) {
        switch (period) {
          case "today": {
            const today = new Date();
            dateRange = this.api.createSingleDayRange(today);
            break;
          }
          case "week":
            dateRange = this.api.createWeekDateRange();
            break;
          case "month":
            dateRange = this.api.createMonthDateRange();
            break;
          default:
            throw new Error(`Invalid period: ${period}`);
        }
      } else if (from_date && to_date) {
        dateRange = this.api.createDateRange(from_date, to_date);
      } else if (from_date) {
        // Single day range
        dateRange = this.api.createSingleDayRange(from_date);
      }
      // If no date parameters, use default (current week)
  
      const schedule = await this.api.getSchedule(
        calendarType,
        dateRange,
      );
  
      return {
        content: [
          {
            type: "text",
            text: `[DATE] Calendar Events (${calendar_type || "personal"})${
              dateRange
                ? ` from ${dateRange.from.toDateString()} to ${dateRange.to.toDateString()}`
                : " (current week)"
            }\n\n${JSON.stringify(schedule, null, 2)}`,
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error: ${error instanceof Error ? error.message : "Unknown error"}\n\nTo authenticate:\n1. Login to N Lobby in your browser\n2. Open Developer Tools (F12)\n3. Go to Application/Storage tab\n4. Copy cookies and use the set_cookies tool\n5. Use health_check to verify connection`,
          },
        ],
      };
    }