← All Guides
📘

bCourses API Token

Step 1 ~2 minutes

bCourses is UC Berkeley’s Canvas LMS. OpenMind uses the Canvas API to read your courses, assignments, grades, announcements, and lecture materials — read-only, and only for the courses you choose. A personal access token is the one credential it needs.

What you'll need

  • - A UC Berkeley account with bCourses access
  • - A web browser
1

Go to bCourses Settings

Open bcourses.berkeley.edu and log in with your CalNet ID.

Click your profile picture (or initials) in the top-left sidebar, then click Settings.

Navigation path:
bCourses → Profile icon (top-left) → Settings
2

Create a New Access Token

Scroll down to the Approved Integrations section.

Click the + New Access Token button.

Fill in the form:

Purpose: OpenMind
Expires: Leave blank (no expiry) or set a date

Click Generate Token.

3

Copy the Token

A dialog will show your new token. Copy it immediately — you won't be able to see it again.

Your token will look something like:

12345~abcdefghijklmnopqrstuvwxyz1234567890

If you lose it, you can always generate a new one from the same Settings page.

4

Paste into OpenMind

When OpenMind asks for your bCourses token during setup, paste it in:

$ openmind setup
Paste your bCourses access token.
It is stored in your operating system’s credential store, not in a file.
 bCourses token: •••••••••
 Token: 12345~****wxyz
 Connected as Oski Bear (America/Los_Angeles).
🔒

Where the token goes

Into your operating system’s credential store — macOS Keychain, Windows Credential Manager, or the Secret Service on Linux. Never into a config file, never into a log line, and never into anything OpenMind returns to your AI app. It is sent only to bcourses.berkeley.edu, and it is dropped before any file download follows a redirect off that host.

Every Canvas call OpenMind makes is a read. There is no code path that can submit work, post a reply, or change a grade. The token itself is not restricted to read-only access, though, so keep it to yourself and revoke it when you stop using OpenMind — Account → Settings → Approved Integrations.