# Classdojo

> Query ClassDojo parent portal. Use for school messages, teacher communications, class stories, student progress, calendar events, or anything ClassDojo-related. Triggers on "ClassDojo", "school message", "teacher message", "how is [student] doing", "class story", "school app".

- **Type:** Skill
- **Install:** `agentstack add skill-m0nkmaster-agent-skills-classdojo`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [m0nkmaster](https://agentstack.voostack.com/s/m0nkmaster)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [m0nkmaster](https://github.com/m0nkmaster)
- **Source:** https://github.com/m0nkmaster/agent-skills/tree/main/classdojo

## Install

```sh
agentstack add skill-m0nkmaster-agent-skills-classdojo
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:
```bash
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):
```bash
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":"","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":"","password":"","code":""}`  
   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

| User Request | Exact Command to Execute |
|-------------|--------------------------|
| "Any messages?" | `cd ~/.cursor/skills/classdojo && python3 scripts/client.py "/parent/5ec3b7790dfcbc1819952ec4/message-thread/page?limit=20"` |
| "What's new?" / "Class stories" | `cd ~/.cursor/skills/classdojo && python3 scripts/client.py "/storyFeed?withStudentCommentsAndLikes=true&withSyntheticPosts=true"` |
| "How is Alice?" | `cd ~/.cursor/skills/classdojo && python3 scripts/client.py "/storyFeed?withStudentCommentsAndLikes=true&withSyntheticPosts=true&studentId=5e7c84d75f8f36d133eddf0e"` |
| "How is Bob?" | `cd ~/.cursor/skills/classdojo && python3 scripts/client.py "/storyFeed?withStudentCommentsAndLikes=true&withSyntheticPosts=true&studentId=5eec913e1634abe97e805598"` |
| "Calendar" / "Events" | `cd ~/.cursor/skills/classdojo && python3 scripts/client.py "/parentCalendarEvent?hidePastEvents=false"` |
| "Alice's info" | `cd ~/.cursor/skills/classdojo && python3 scripts/client.py "/parent/5ec3b7790dfcbc1819952ec4/student/5e7c84d75f8f36d133eddf0e"` |
| "Dashboard" | `cd ~/.cursor/skills/classdojo && python3 scripts/client.py "/parent/5ec3b7790dfcbc1819952ec4/dashboard"` |

## 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

| Error | Action |
|-------|--------|
| "Session expired" or 401 | Go back to step 2, login again (use `--code` if ClassDojo emails an OTP), then retry step 3 |
| "No session found" | Go to step 2 and login |
| Empty JSON/array | "No [items] found right now" |
| Any HTTP error | "ClassDojo is temporarily unavailable" |

## 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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [m0nkmaster](https://github.com/m0nkmaster)
- **Source:** [m0nkmaster/agent-skills](https://github.com/m0nkmaster/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-m0nkmaster-agent-skills-classdojo
- Seller: https://agentstack.voostack.com/s/m0nkmaster
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.