edstem grades lists your own grades in one unit. It only covers lessons that take submissions, and only your final submission counts.
edstem grades UNIT defaults to list. Every word after UNIT must appear in the lesson’s title or its module name (case-insensitive, all words required), the same matching as lessons mark-read. With no words, every submission lesson in the unit is listed.
What each row means
grade uses a staff override when there is one. max is the sum of Ed’s slide totals for the lesson, so it can differ from the mark scale shown in a lesson’s own instructions. submittedAt is when your final submission was made.
Cost
Besides finding the unit, one request for its lessons and one for your user, then two per lesson you submitted. Lessons you never submitted cost nothing extra, and up to three lessons are checked at once. An expired token or a lost connection stops the whole listing rather than marking every lessonunavailable.
grades is read-only. MCP clients get the same rows from the list_grades tool (edstem-cli 0.8.4 and later), which takes courseId and optional queries. See the MCP tool catalog.