Classdojo

ClassDojo Parent Portal

This skill queries the ClassDojo parent portal API.

⚡ QUICK START (For AI)

When user asks ANYTHING about ClassDojo:

1. Run auth check: cd ~/.cursor/skills/classdojo && python3 scripts/client.py session-check
2. If NOT authenticated: Ask user for email/password, then run: cd ~/.cursor/skills/classdojo && python3 scripts/cli_login.py --email "EMAIL" --password "PASSWORD" (add --code "123456" if they were emailed a 6-digit OTP — see Email OTP (new location) below)
3. Make API call: Use commands from the table below
4. Parse JSON and respond conversationally

CRITICAL: You (the AI) run these commands. Python3 IS installed. Do NOT ask the user to run commands.

CRITICAL: How to Handle Any Request

For EVERY ClassDojo request, follow this exact workflow:

1. Check Auth Status (ALWAYS DO THIS FIRST)

Execute:

cd ~/.cursor/skills/classdojo && python3 scripts/client.py session-check

Interpret the result:

• Output contains "authenticated": true → Go to step 3
• Output contains "authenticated": false or any error → Go to step 2

2. Login If Needed

Say to user: "I need your ClassDojo email and password to access your account."

When user provides credentials, execute (replace with actual values):

cd ~/.cursor/skills/classdojo && python3 scripts/cli_login.py --email "USER_PROVIDED_EMAIL" --password "USER_PROVIDED_PASSWORD"

If successful: "Logged in. Session saved..." appears → Go to step 3
If failed: Tell user credentials didn't work, ask them to try again
If stderr mentions the 6-digit code / HTTP 401 after correct password: ClassDojo emailed an OTP — ask for the code, then run the same command with --code "THE_CODE" (or set CLASSDOJO_OTP_CODE)

Email OTP (new location / device)

1. Password step: POST https://home.classdojo.com/api/session?duration=long with JSON
   {"login":"<email>","password":"<password>","resumeAddClassFlow":false}
   When a code is required, this returns 401 (response may include rate-limit headers such as remaining-attempts, retry-after).
2. OTP step: POST https://teach.classdojo.com/api/session?duration=long with JSON
   {"login":"<email>","password":"<password>","code":"<6-digit>"}
   On success (200), session cookies are issued like a normal login.

The parent portal UI strings for this flow live in home.classdojo.com locale pack packages-one-time-codes (e.g. “Enter the 6-digit code”, “We sent a one-time code to your email address”). Optional account MFA is a separate concept (GET /api/parent/{id}/mfa); this OTP is not the same as enabled TOTP MFA.

CLI: python3 scripts/cli_login.py --email "…" --password "…" --code "123456"

3. Make API Request

Execute the appropriate command from the table below.

API Commands Reference

Response Format

Parse the JSON output and respond like:

• Messages: "New message from [Name] ([time]): '[preview]'"
• Stories: "[Teacher] posted: '[content]' ([X] photos, [Y] likes)"
• Calendar: "Upcoming: [Event] - [Date] at [Time]"

Error Handling

Important Notes

• Python3 is installed - always use python3 in commands
• You execute the commands - don't ask the user to run them
• Never echo passwords - use them in commands but don't show in responses
• Session persists - after login, the session file is created automatically
• Always check auth first - never skip step 1