Viewpoint School · MyVP
MyVP, from the
terminal.
Assignments, submissions, schedule and grades as a fast web app, a CLI, Python SDK, HTTP API and MCP server. It signs itself back in, so you stay logged in.
01 Install macOS
$ curl -fsSL https://blackbaud.myronlai.com/install.sh | sh
Installs uv if it is missing, the blackbaud command, the blackbaud-ui web app, and Chromium for Google sign-in. Run it again to update.
Install preview
Terminal
$ curl -fsSL https://blackbaud.myronlai.com/install.sh | sh show output
Resolved 84 packages in 670ms
Prepared 84 packages in 1.11s
Installed 84 packages in 57ms
Bytecode compiled 3442 files in 710ms
+ blackbaud-sdk==0.2.0 (from https://blackbaud.myronlai.com/blackbaud_sdk-0.2.0-py3-none-any.whl)
+ blackbaud-ui==0.1.0 (from https://blackbaud.myronlai.com/blackbaud_ui-0.1.0-py3-none-any.whl)
Installed 1 executable from `blackbaud-ui`: blackbaud-ui
Installed 1 executable: blackbaud
Installed. Next: blackbaud setup, then blackbaud-ui for the web app
$ blackbaud setup show output
Blackbaud setup · press Enter for the default, or answer no to skip a step
1. Sign in
✗ Not logged in
1. Copy the session from a browser logged in to MyVP (recommended)
2. Sign in with Google (email and password)
3. Skip
Choose sign-in method [1]: 1
Logged in via arc → /Users/you/.blackbaud/storage_state.json
2. Background keep-alive
✗ Keep-alive service not installed
Install it so you stay logged in (starts at login, pings every 5 min)? [Y/n]: y
✓ Keep-alive service running (pid 25175)
3. Keep browsers logged in
– No browsers kept logged in (optional)
Look for browsers logged in to MyVP? (macOS may ask for Keychain access) [Y/n]: y
Browsers with MyVP cookies:
1. ✓ arc · Profile 2 — logged in (active 1 min ago)
Keep which logged in? (numbers, e.g. 1,3) [1]: 1
✓ Browsers kept logged in: arc · Profile 2
Done. Useful commands:
blackbaud assignments --pending what's due
blackbaud schedule today's classes
blackbaud gradebook scores for a course
blackbaud submit turn in work (pick from a list)
blackbaud --help every command
$ blackbaud-ui show output
INFO: Started server process [75646]
INFO: Waiting for application startup.
INFO: Application startup complete.
INFO: Uvicorn running on http://127.0.0.1:8110 (Press CTRL+C to quit)
$
02 Sign in
$ blackbaud setup
Signs in, starts the background keep-alive, and keeps your browsers logged in to MyVP. Every step shows its state and can be skipped. When Keychain asks to read a browser's cookies, Allow is enough once; choose Always Allow if the keep-alive should keep that browser logged in. Either way it covers all of that browser's cookies.
03 Open the app
Starts the web app on your Mac and opens 127.0.0.1:8110: to do, schedule, grades and classes, and you can mark work done or submit it from there. Keep that terminal window open while you use it; Ctrl+C stops it. Sign in with blackbaud setup first. Port taken? PORT=8120 blackbaud-ui.
04 Never get signed out Optional
$ blackbaud browsers extension
MyVP in your own browser signs you out after 90 minutes asleep or idle. This adds a small extension that renews the session through the CLI, and signs you straight back in after the lid was closed. Works in Arc, Chrome, Brave, Edge and other Chromium browsers. The command registers it and copies a folder path; then, once per browser profile you use MyVP in:
- Open
arc://extensions (or chrome://, brave://, edge://extensions)
- Turn on Developer mode
- Load unpacked, paste, Enter, Open
Only Blackbaud cookies pass between the extension and the CLI. Browsers only allow automatic installs from the Chrome Web Store, hence the three clicks.
05 Use the CLI
blackbaudHome: login streak, service, kept browsers
blackbaud assignments --upcoming --pendingWhat is due
blackbaud schedule --nextYour next class
blackbaud gradesEvery course, straight from Blackbaud
blackbaud submitSave a draft or turn in text and files
blackbaud serveLocal HTTP API on 127.0.0.1:8100
Add --json for scripts. blackbaud --help lists everything.
06 Agents
Paste this to Claude Code, Codex, or any coding agent:
Install blackbaud-sdk for me by following https://blackbaud.myronlai.com/llms.txt
Or wire it up yourself. MCP server:
{ "mcpServers": { "blackbaud": { "command": "blackbaud", "args": ["mcp"] } } }
Agent skill, into Claude Code:
$ mkdir -p ~/.claude/skills && curl -fsSL https://blackbaud.myronlai.com/skill.tar.gz | tar xz -C ~/.claude/skills