brightspace-d2l-mcp

Brightspace D2L MCP Server

Connect D2L Brightspace to Claude, ChatGPT, Cursor and Copilot.
It knows what you already handed in, so it only shows what is actually left.

One command. Sign in the way you always do. No passwords stored.

brightspace-mcp.netlify.app

An MCP (Model Context Protocol) server that gives AI assistants and agents read access to your Brightspace courses: due dates with real submission status, grades, assignments, rubrics, course content, announcements, discussions and class lists. It works at any school that uses D2L Brightspace, including schools with Microsoft, Duo, Okta or Shibboleth single sign-on.

Quick start

You need Node.js 20 or newer and Google Chrome or Microsoft Edge.

npx brightspace-d2l-mcp setup

That's it. Setup asks for your school, opens a browser so you can sign in, and connects every AI app it finds. Then ask your AI:

"What should I work on right now?"

New to this? The step-by-step setup guide walks through everything with pictures of each step. Using a specific app? See the guides for Claude and ChatGPT, or how this compares to other Brightspace MCP servers.

How it compares

People usually weigh a few Brightspace MCP servers before picking one. Here are the three differences that come up most, with the full comparison for the rest:

"No target-grade tool in its published list" means we could not find one in each project's public README and tool list as of October 2026, not that it can never be added. Spot a mistake in the table? Open an issue and it will be fixed.

Switching from brightspace-mcp-server

If you are running brightspace-mcp-server by RohanMuppa and want to try this one, you only change the package name. Everything else stays where it is.

In your MCP config, find the brightspace entry inside mcpServers and swap the command:

{
  "mcpServers": {
    "brightspace": {
      "command": "npx",
      "args": ["-y", "brightspace-d2l-mcp@latest"]
    }
  }
}

On Windows, wrap the launch in cmd /c the same way you do now:

{
  "mcpServers": {
    "brightspace": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "brightspace-d2l-mcp@latest"]
    }
  }
}

Then restart the app. If you would rather not edit files, run npx brightspace-d2l-mcp setup: it asks for your school, opens a browser window so you sign in, and writes this entry for you. You can also print the exact JSON for any app with npx brightspace-d2l-mcp config.

What carries over and what doesn't

Want to go back? Put the old command back in the same spot. Both servers can even be configured side by side under two different server names, but one AI app talking to two Brightspace servers at once tends to be more confusing than it is worth.

A few things the first server does are not done here: it can sign you in without a browser window by saving your password in your computer's credential store, and it ships presets for several named schools. This server always opens a normal browser window where you sign in yourself, which is what makes any single sign-on work, and all it keeps afterward is your browser session.

What you can ask

It knows what you've already handed in

Most tools only see due dates, so they keep telling you to do work you've finished. This one checks your actual submission for every assignment:

Tools

17 MCP tools for D2L Brightspace. Everything reads from Brightspace and nothing is ever changed there:

Prompts and example questions

Apps that support MCP prompts show these as one click shortcuts or slash commands. You do not have to remember the names: typing the example question in a normal chat works too, because each prompt simply tells the AI which tools to call.

Works at any Brightspace school

Every school signs in differently: Microsoft, ADFS, Duo, Shibboleth, Okta, Google, campus pickers, or Brightspace's own form. Instead of guessing how your school works, setup opens a normal browser window and you sign in exactly like you do every day, text codes and authenticator apps included.

After that it stays signed in quietly in the background. If your school ever asks you to sign in again, the browser window simply pops up and closes by itself when you're done.

Does my school work?

If your school uses D2L Brightspace, yes. Setup opens a normal browser window so any sign-in works, including Microsoft, Duo, Okta and Shibboleth.

Works with your AI app or agent

Connected automatically by setup: Claude Desktop · Claude Code · Cursor · VS Code (GitHub Copilot) · Windsurf · OpenAI Codex · Gemini CLI · Cline · Roo Code · OpenCode · Zed · LM Studio · Kiro

One copy-paste away: ChatGPT (developer mode) · Continue · Goose · JetBrains AI Assistant · Warp · Amp · Msty · Jan · AnythingLLM

Agent frameworks: OpenAI Agents SDK · Claude Agent SDK · LangChain / LangGraph · Vercel AI SDK · Mastra · CrewAI · Pydantic AI · LlamaIndex

It runs over stdio for local apps and streamable HTTP (serve --http) for ChatGPT and hosted agents. See docs/agents.md for copy-paste setup for every one of these.

Install it with your AI

Paste this into Claude Code, Cursor, Windsurf, Copilot or Codex and it will set everything up for you.

Install brightspace-d2l-mcp for me by following
https://github.com/AnonymousOnyx22/brightspace-d2l-mcp/blob/main/llms.txt

Commands

When a newer version is out, commands ask whether to update first. Set BRIGHTSPACE_NO_UPDATE_CHECK=1 to turn that off.

npx brightspace-d2l-mcp setup --school yourschool.brightspace.com   # skip the school question
npx brightspace-d2l-mcp setup --apps claude-desktop,cursor          # only connect these apps
npx brightspace-d2l-mcp setup --skip-login                          # sign in later, on first use
npx brightspace-d2l-mcp setup --yes                                 # accept every default

Privacy and security

• Your password is never seen or stored. You type it into your school's own sign-in page in a real browser.
• Read-only. It can't submit, post, or change anything in Brightspace. No tool sends anything but GET requests, the API client has no write methods at all, and a test fails the build if one is ever added. See how read-only is enforced.
• Local only. Everything runs on your computer and talks only to your school's Brightspace. There's no server in between, and no analytics.
• Uses the official Brightspace API with the same access you have in your browser.
• Your session is saved in ~/.brightspace-d2l-mcp/, readable only by your user account. logout deletes it; uninstall deletes everything.

Troubleshooting

Something not working? docs/troubleshooting.md walks through an app that shows no Brightspace tools, a setup window that never opens, and a single sign on that keeps failing, with the exact message each one prints. It starts with npx brightspace-d2l-mcp doctor.

{ "excludeCourses": [123456, 789012] }

FAQ

Development

git clone https://github.com/AnonymousOnyx22/brightspace-d2l-mcp.git
cd brightspace-d2l-mcp
npm install
npm run build
npm test
node build/index.js setup     # connects your AI apps to this local build

Tools live in src/tools/, sign-in in src/auth/, and setup in src/cli/. Issues and pull requests are welcome.

More free student MCP servers

All free, open source and read only where they touch your accounts. Browse the full list at brightspacemcp.com/more-mcps.

License

MIT © AnonymousOnyx22

D2L and Brightspace are trademarks of D2L Corporation. This project is not affiliated with D2L.