Skip to content
MCP server

Brightspace

Read-only access to D2L Brightspace grades, due dates, announcements and course files

Runs locallyStatus and history
Install
Pricing
Free
Platforms
self-hosted, CLI, macOS
Runs
Locally
Version
5.2.11
Listing updated
today

Similar MCP servers

About Brightspace

Brightspace is a free MCP server for education and exams. It runs locally on your machine and is started by your AI client.

Students ask in plain words what is due, whether they are passing, or what a professor posted, and the server answers from their own Brightspace account. It only reads: the README says it never submits, edits or deletes anything.

Setup is a single npx -y brightspace-mcp-server@latest setup command that asks for your school's address, username and how you confirm sign-in. The password goes into the operating system's credential store (Keychain or Credential Manager), and encrypted tokens are kept per school and account. Built-in sign-in flows exist for Purdue, SUNY, Western, TU Delft, CUNY, Leiden, McGill, Memorial, Javeriana Cali and Ngee Ann; any other D2L school can paste its address.

It covers grades, assignments and rubrics, quizzes, announcements, syllabi, discussions, calendar, people and lecture-video transcripts, and a sync command downloads a whole course (capped at 300 files and 5 GB per run) into folders named after its modules. When Brightspace hides data, answers say unknown or incomplete rather than guessing.

Install

Run in a terminal

claude mcp add brightspace -- npx -y brightspace-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "brightspace": {
      "command": "npx",
      "args": [
        "-y",
        "brightspace-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "brightspace": {
      "command": "npx",
      "args": [
        "-y",
        "brightspace-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "brightspace": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "brightspace-mcp-server"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "brightspace": {
      "command": "npx",
      "args": [
        "-y",
        "brightspace-mcp-server"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "brightspace": {
      "command": "npx",
      "args": [
        "-y",
        "brightspace-mcp-server"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • D2L_BASE_URLYour school's Brightspace URL. Default: https://purdue.brightspace.com. Normally set by the setup wizard in ~/.brightspace-mcp/config.json instead.
  • D2L_SESSION_DIRLocal root for separate per-school/account directories containing encrypted tokens and browser storage. Encryption keys are kept in the native credential store. Default: ~/.d2l-session
  • D2L_HEADLESSRun browser authentication without a visible window. Set false only for MFA methods that require browser interaction. Default: true
  • D2L_TOKEN_TTLSeconds an access token is used before it is re-minted from the session cookie. Default: 3600
  • D2L_INCLUDE_COURSESComma separated course (org unit) ids to include. Default: all enrolled courses.
  • D2L_EXCLUDE_COURSESComma separated course (org unit) ids to exclude.
  • D2L_ACTIVE_ONLYOnly return courses whose enrollment is active. Default: true
  • D2L_CURRENT_ONLYOnly return courses whose Access.StartDate to Access.EndDate window contains now, matching Brightspace's "Current Courses" widget. Default: false
  • D2L_DEV_MODESet to true to record local tool timestamps and safe authentication outcomes in the account session directory. No arguments, results or credentials are logged. Default: false.
  • D2L_NO_UPDATE_CHECKSet to any value to disable the startup check against the npm registry for a newer version.

What it does

Grades and due dates
Answers what is due soon and how you are doing per course.
Course content
Finds, reads and downloads module files and syllabi.
Course sync
Saves a whole course to a folder and fetches only new files on rerun.
Lecture transcripts
Reads Kaltura and YouTube recordings for questions about lectures.
School sign-in presets
Automatic login flows for ten named schools plus any D2L address.
Honest gaps
Reports unknown or incomplete when Brightspace hides data.

Good for

  • Ask what is due in the next 48 hours
  • Compare grades across all classes
  • Download every PDF from a module
  • Turn lecture slides into flashcards
  • Find who the TAs are for a course

Pricing

Free

No price listed

Brightspace FAQ

Can it submit or change anything?

No. It only reads your courses.

Where is my password stored?

In the system credential store, not in a file.

Does my school work?

Any school on D2L Brightspace should; ten schools have built-in sign-in flows.

What Node version is needed?

Node.js 22 or newer.

Is Brightspace free?

Yes. Brightspace is free to use.

How do I add Brightspace to Claude Code?

Run this command in your terminal: claude mcp add brightspace -- npx -y brightspace-mcp-server

What are the best alternatives to Brightspace?

The closest alternatives to Brightspace are Penline Handwriting Sheets, Lumen, Education Mcp, Born Then and FreeDict.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers