Blackbaud

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

$ blackbaud-ui

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:

  1. Open arc://extensions (or chrome://, brave://, edge://extensions)
  2. Turn on Developer mode
  3. 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

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