This MCP server provides programmatic access to N Lobby school portal data via the MCP protocol. It exposes resources such as news, schedules, required courses, and user profiles, and supports authentication workflows using browser-based login or cookie management. Available tools include authentication utilities (interactive_login, login_help, set_cookies, check_cookies, verify_authentication), data retrieval tools (get_news, get_news_detail, get_required_courses, get_schedule, get_calendar_events, test_calendar_endpoints, mark_news_as_read), and debugging helpers (health_check, debug_connection, test_page_content, test_trpc_endpoint). You can connect to the server with an MCP client and issue these tool commands to fetch or manipulate data within your authorized N Lobby account. The server uses browser-based authentication to obtain cookies and then uses those cookies to access school data securely across clients.

Prerequisites:

• Node.js and npm (or pnpm for development steps)
• Basic familiarity with the MCP client you plan to use

Option 1: Install from npm (Recommended)

1. Install globally: npm install -g nlobby-mcp

2. Run the server (when installed globally): nlobby-mcp

Option 2: Development Installation

1. Clone the repository: git clone https://github.com/minagishl/nlobby-mcp.git cd nlobby-mcp

2. Install dependencies: pnpm install

3. Set up environment variables: cp .env.example .env

   Edit .env if needed (default values should work)

4. Build the project: pnpm run build

Notes:

• The server reads configuration from a .env file. Ensure NLOBBY_BASE_URL is set to your N Lobby portal base URL.
• If you are using a different package manager, adjust commands accordingly (e.g., npm install, npm run build).

Tips and common considerations:

• Ensure NLOBBY_BASE_URL is correct to enable the login flow and data access.
• The interactive_login tool opens a browser for manual login; cookies are stored for subsequent requests.
• If you encounter authentication issues, use check_cookies and health_check to verify cookie status and connectivity.
• When using Cursor, Claude Desktop, or other MCP clients, you can point to the nlobby-mcp package via npx or a local node dist path as shown in the README.
• The server supports multiple calendar types (personal and school); use get_calendar_events with calendar_type and period filters to retrieve data.
• For development, keep your environment variables in a .env file and avoid exposing sensitive data in public configurations.