Brightspace Mcp Server

What is Brightspace Mcp Server?

Brightspace Mcp Server is an MCP (Model Context Protocol) server that connects AI applications like Claude, ChatGPT, and Cursor to a student’s Brightspace learning management system. It allows users to query grades, assignments, announcements, course content, and more directly through natural language prompts. Built for any school using Brightspace, it runs locally via Node.js and handles authentication and session management.

How to use Brightspace Mcp Server?

Requires Node.js 18+. Run npx brightspace-mcp-server setup (add --purdue for Purdue University) to launch a wizard that handles credentials, MFA, and AI client configuration. After installation, restart the AI client and start asking questions. If a session expires, use npx brightspace-mcp-server auth to re-authenticate.

Key features of Brightspace Mcp Server

• Query real-time grades across all courses
• List upcoming assignments and due dates
• Retrieve course announcements and discussion posts
• Download lecture slides and course content
• View course roster with instructor/TA contact info
• Works with any Brightspace‑enabled institution
• Automatic session re‑authentication and encrypted local storage

Use cases of Brightspace Mcp Server

• “Am I passing all my classes?” – check current grades across courses.
• “What’s due in the next 48 hours?” – summarize pending assignments.
• “Download the midterm review slides and turn them into flashcards.”
• “Build me a study schedule based on my upcoming due dates.”
• “Summarize the latest discussion posts from my CS class.”

FAQ from Brightspace Mcp Server

What runtime or dependencies are required?

Node.js 18+ must be installed. On WSL or Docker, additional Playwright dependencies may be needed (npx playwright install-deps chromium).

Where are my credentials stored?

Credentials and session tokens remain on your local machine at ~/.brightspace-mcp/config.json. Session tokens are encrypted (AES‑256‑GCM), and all traffic to Brightspace uses HTTPS.

How does authentication work?

The setup wizard handles credentials and multi‑factor authentication (e.g., Duo push). Sessions re‑authenticate automatically; if auto‑reauth fails, run npx brightspace-mcp-server auth to retry.

What if the headless login fails on Windows?

The default login mode is headed (a browser window opens). If headless mode was enabled and fails, switch back to headed mode by removing the D2L_HEADLESS=true environment variable.

Is any data sent to third parties?

No. All data stays local or goes directly to your school’s Brightspace instance. Nothing is sent to any external server other than the login page and Brightspace API endpoints.