BYU Learning Suite MCP Server

A local MCP server that exposes BYU Learning Suite data (assignments, grades, schedule, announcements, exams, and course content) as tools for Claude Desktop.

Currently uses mock data for a BYU junior Finance student (Spring 2026). The data layer is modular — swap mockAdapter.js for a real scraper without changing any MCP logic.

Setup

cd byu-learning-suite-mcp
npm install

Run Standalone (for testing)

npm start

The server communicates over stdio, so you won't see output — it's waiting for MCP messages.

Connect to Claude Desktop

Add the following to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "byu-learning-suite": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/byu-learning-suite-mcp/src/index.js"]
    }
  }
}

Replace the path with your actual absolute path, then restart Claude Desktop.

Available Tools

Tool	Description	Params
get_assignments	Upcoming assignments	course?, days_ahead? (default 14)
get_grades	Grade summary (or drill into one course)	course?
get_schedule	Weekly class schedule	—
get_announcements	Recent announcements	course?, limit? (default 10)
get_exams	Upcoming exams & testing center windows	course?
get_content	Course content & resources	course?

Architecture

src/
├── index.js              # MCP server entry point
├── tools/
│   └── index.js          # Tool definitions (MCP schema + handlers)
└── data/
    ├── adapter.js        # Adapter interface (dependency injection point)
    ├── mockAdapter.js    # Mock implementation (filters/sorts mock data)
    └── mockData.js       # Raw mock data (courses, assignments, grades, etc.)

Swapping to a Real Backend

1. Create src/data/scraperAdapter.js exporting an object with the same interface as mockDataSource (each method is async and returns the expected shape).
2. In src/index.js, import your scraper and pass it to createAdapter():

import { scraperDataSource } from "./data/scraperAdapter.js";
const data = createAdapter(scraperDataSource);

That's it — the tools and MCP server remain unchanged.