brightspace
CommunityMCP server by RohanMuppa · updated · ★ 59 · 3.6k downloads a week
D2L Brightspace MCP server: grades, due dates, assignments, announcements and files. Any school. brightspace is a community project by RohanMuppa, not verified by a company domain.
Last commit 3 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, 59 stars, original repository
Runs a script automatically when the package is installed
What you need
| Setting | Needed | What it is |
|---|---|---|
D2L_BASE_URLEnvironment variable | Optional | Your school's Brightspace URL. Default: https://purdue.brightspace.com. Normally set by the setup wizard in ~/.brightspace-mcp/config.json instead. |
D2L_SESSION_DIREnvironment variable | Optional | Local 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_HEADLESSEnvironment variable | Optional | Run browser authentication without a visible window. Set false only for MFA methods that require browser interaction. Default: true |
D2L_TOKEN_TTLEnvironment variable | Optional | Seconds an access token is used before it is re-minted from the session cookie. Default: 3600 |
D2L_INCLUDE_COURSESEnvironment variable | Optional | Comma separated course (org unit) ids to include. Default: all enrolled courses. |
D2L_EXCLUDE_COURSESEnvironment variable | Optional | Comma separated course (org unit) ids to exclude. |
D2L_ACTIVE_ONLYEnvironment variable | Optional | Only return courses whose enrollment is active. Default: true |
D2L_CURRENT_ONLYEnvironment variable | Optional | Only return courses whose Access.StartDate to Access.EndDate window contains now, matching Brightspace's "Current Courses" widget. Default: false |
D2L_DEV_MODEEnvironment variable | Optional | Set 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_CHECKEnvironment variable | Optional | Set to any value to disable the startup check against the npm registry for a newer version. |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install brightspace
Built from the published package, never by AIclaude mcp add brightspace -- npx -y brightspace-mcp-serverRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"brightspace": {
"command": "npx",
"args": [
"-y",
"brightspace-mcp-server"
]
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"brightspace": {
"command": "npx",
"args": [
"-y",
"brightspace-mcp-server"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"brightspace": {
"command": "npx",
"args": [
"-y",
"brightspace-mcp-server"
]
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add brightspace -- npx -y brightspace-mcp-server{
"mcpServers": {
"brightspace": {
"command": "npx",
"args": [
"-y",
"brightspace-mcp-server"
]
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add brightspace npx -y brightspace-mcp-serverGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the brightspace block.
Security check
B- Runs a script automatically when the package is installedIn
package.json:"postinstall":
Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to brightspace
All alternatives →Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
Open-source Obsidian for MDX - edit local docs with agent assistance
A private persistent computer: files and a bash shell that survive between runs.
MCP server for terminal commands, file operations, and process management
Filesystem-first framework for durable backend AI agents that run anywhere.
W3C Web Model Context Protocol (WebMCP) API polyfill. Let AI agents like Claude, ChatGPT, and Gemini interact with your website via document.modelContext.
brightspace: common questions
How do I install brightspace?
In Claude Code run claude mcp add brightspace -- npx -y brightspace-mcp-server. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is brightspace the official server?
brightspace is a community project by RohanMuppa, not verified by a company domain.
Is brightspace free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is brightspace safe to use?
It scores 86 of 100. Grades: maintenance A, licence A, quality B. Security check: grade B (runs a script automatically when the package is installed). Review the code before you install. How grades work.
What are alternatives to brightspace?
Similar MCP servers: mcp-server, Agent-Native Content, Computer, Desktop Commander.
Does brightspace work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
