Brightspace MCP server
io.github.JhostinAleck/brightspace·v1.3.2·15 starsD2L Brightspace MCP server: courses, grades, rubrics, feedback, course files, calendar. Multi-auth.
15 stars405 downloads/wk
Reviews
Write oneNobody has reviewed Brightspace yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Brightspace tools (31, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
check_authVerify whether the server can talk to Brightspace on your behalf.
clear_cacheClear cached responses. Use when the user asks to refresh data, or when tools return stale values.
get_announcementReturn one announcement in full (body as text with links kept) and its attachments;
get_announcementsReturn course announcements, pinned first then newest first, each with its id, date, author,
get_assignment_filesDownload and read the attachments (instructions, templates) posted on a Brightspace assignment.
get_assignment_rubricReturn the grading rubric of an assignment: criteria groups, criteria, levels, points and level descriptions.
get_assignmentsList assignments (Brightspace Dropbox Folders) for a course.
get_audit_logReturn the local audit history of write attempts (submit_assignment, post_discussion_reply, mark_announcement_read).
get_calendar_eventsReturn course calendar events within the next N days (default 30). Useful for seeing exams, lectures, or instructor-scheduled events.
get_classlist_emailsReturn the email addresses for everyone enrolled in a course.
get_course_contentReturn the course module tree with topics (files, links, quizzes, LTI tools, etc.),
get_course_fileDownload and read a file stored in the course content area (/content/enforced/{course}-.../file.pdf) —
get_diagnosticsReturn a JSON report of server state: profile, base URL, discovered D2L versions, cache hit/miss counters, and HTTP request timing stats.
get_discussionsReturn the list of discussion forums and topics for a course, with post counts and last-post timestamps.
get_feedbackReturn the instructor feedback for a single assignment in a given course.
get_moduleReturn one content module in full: its complete description text, every link or embedded file it contains,
get_my_gradesReturn grades for a specific course by numeric course id.
get_my_groupsList the groups you are enrolled in for a course (with member names).
get_my_submissionsList the files the user (or their group) submitted to an assignment, newest first — works for open and closed folders.
get_quiz_attemptsList your attempts on a single quiz with scores and submission status.
get_rosterList classmates, instructors, and TAs for a given course.
get_syllabusReturn the course syllabus (overview page) as plain text.
get_topic_fileDownload and read a content topic file from a Brightspace course.
get_upcoming_due_datesReturn assignments and quizzes with due dates across all active courses within the next N days (default 14).
list_my_coursesList enrolled courses.
list_notificationsShow your Brightspace activity feed (announcements, due-date reminders, grade releases, etc.).
list_quizzesList quizzes for a course with attempt counts, time limits, and close dates.
mark_announcement_readMark a Brightspace announcement as read. Writes: require --enable-writes + config writes.enabled: true.
post_discussion_replywrite actionReply to a Brightspace discussion topic. Writes: require --enable-writes + config writes.enabled: true.
search_courseFull-text search across course content, announcements, and discussion forums.
submit_assignmentwrite actionUpload a file to a Brightspace Dropbox Folder. Pass either `file_path` (recommended for files >1 MB — read server-side, saves tokens) or `content_base64`.
Public scan report
scanner v0.1.10 · 2026-11-10 · same rubric, same numbers if you re-run it
- Code scan274 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Brightspace compares
Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 90% of 1,293 Productivity servers
- Tools
- 31
- the typical Productivity server has 7
- Tools that change things
- 6%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 15
- more than 80% of 858 Productivity servers
- Downloads a week
- 405
- more than 80% of 488 Productivity servers with a package
What its tools let an agent do: 28 read · 2 change · 1 send or post
Release history: 3 versions in the registry since 2026-05-12, latest 2026-11-05, typically one every 139 days.
Install Brightspace in Claude Code, Cursor or VS Code
Runs npx -y brightspace-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add brightspace -- npx -y brightspace-mcp
What the publisher says
From the Brightspace repository's README, as published. We do not edit it. Read it on GitHub
brightspace-mcp
📖 Full documentation site →
MCP server for D2L Brightspace. Gives Claude (and any MCP-compatible client) access to your courses, grades, assignments, content, calendar, and more — with multi-strategy authentication, full MFA support, and production-grade resilience built in.
Quick start
npx brightspace-mcp@latest setup # interactive wizard (recommended for first time)The interactive wizard handles everything: base URL, auth strategy, MFA, credential storage, and auto-registration with Claude Desktop / Cursor / Windsurf.
For CI pipelines or DevContainers with no TTY, use the non-interactive init command instead:
npx brightspace-mcp@latest init \
--base-url https://yourschool.brightspace.com \
--strategy api_token \
--token-ref env:BRIGHTSPACE_API_TOKENDocumentation
Deep-dive guides live in docs/ — start with docs/README.md.
For AI assistants and contributors, AGENTS.md is a one-page map of the repo.
Table of contents
- Installation
- Authentication strategies
- MFA strategies
- Configuration reference
- Output: timezone and language
- Redis cache
- Write operations
- Available tools
- MCP Resources
- MCP Prompts
- TUI dashboard
- Register with an MCP client
Installation
npx (recommended — no install needed)
npx brightspace-mcp@latest setup # first-time wizard
npx brightspace-mcp@latest serve # run the serverGlobal install
npm install -g brightspace-mcp
brightspace-mcp setup
brightspace-mcp serveFrom source
git clone https://github.com/JhostinAleck/brightspace-mcp.git
cd brightspace-mcp
npm install && npm run build
node build/cli/main.js serveRequirements: Node.js ≥ 20.
Authentication strategies
Pick the strategy that matches your Brightspace setup. Run npx brightspace-mcp@latest setup and it will walk you through the right one.
API Token (simplest)
Requires a Valence API token from your Brightspace admin panel.
profiles:
my_school:
base_url: https://school.brightspace.com
auth:
strategy: api_token
api_token:
token_ref: env:BRIGHTSPACE_API_TOKENShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Grade history
- 2026-11-10restoreC → Ascore 92
Brightspace: common questions
- Is Brightspace MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Brightspace safety report
- How do I install Brightspace?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Brightspace need an API key?
- No secret keys are declared. It reads 1 setting from the environment.
- Is Brightspace maintained?
- The last commit was 6 days ago (2026-11-09). The latest release is v1.3.2.
- What can I use instead of Brightspace?
- Servers from other publishers that do the same job: AIquila — Nextcloud MCP Server, Mu MCP server and Apple Tools (Unified) MCP server. Compare all Brightspace alternatives.
- How does Brightspace compare with other Productivity MCP servers?
- safety score 92/100 (higher than 90% of 1,293 Productivity servers); tools 31 (the typical Productivity server has 7); tools that change things 6% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Brightspace
Same job from other publishers: the closest match first, then the best rated.
- AIquila — Nextcloud MCP ServerNextcloud MCP server — 384 tools: files, calendar, contacts, mail, Talk, Deck, photos, maps, notesnot reviewedEstablishedC
MuNews, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.not reviewedEstablishedB- Apple Tools (Unified)Unified Apple ecosystem MCP server for macOS: Mail, Calendar, Notes, Files, Messages, and more.not reviewedEstablishedA
- Agent-Native CalendarAgent-Native Google Calendar - manage events, sync, and public bookingnot reviewedEstablishedA
- DocsSearch and read Empryo's documentation. Read-only, no auth, no local access.not reviewedEstablishedA