gws-classroom

googleworkspace/cli

Manage Google Classroom courses, rosters, and assignments via CLI.

What is gws-classroom?

Google Classroom skill provides command-line access to create and manage courses, handle student/teacher rosters, manage coursework and assignments, and configure grading periods. Use it when you need programmatic control over Classroom operations within a Google Workspace domain.

Create, retrieve, update, and delete courses
Manage course rosters (add/remove students and teachers via invitations)
Create and manage course work, assignments, and materials
Configure grading period settings for courses
List and retrieve user profiles and guardian information
Set up notifications via Cloud Pub/Sub registrations

How to install gws-classroom

npx skills add null --skill gws-classroom

Prerequisites

Google Workspace account with Classroom enabled
gws CLI installed and authenticated (see gws-shared skill)
Appropriate permissions to create/modify courses in your domain

Claude Code

Cursor

Windsurf

Cline

How to use gws-classroom

1.Run `gws classroom --help` to browse available resources and methods
2.Use `gws schema classroom.<resource>.<method>` to inspect required parameters and types
3.Build commands with `gws classroom <resource> <method> [flags]` using `--params` or `--json` for arguments
4.Execute the command to perform the operation (create course, add student, etc.)
5.Check output for created/modified resource IDs and status

Use cases

Good for

Bulk create courses for a semester and assign teachers to each
Programmatically enroll students into courses using invitations
Retrieve course rosters and student submission status
Automate course setup with topics, announcements, and initial materials
Monitor Classroom activity via Cloud Pub/Sub notifications

Who it's for

Google Workspace domain administrators
Educational institution IT teams
Developers building Classroom integrations
Educators automating course management at scale

gws-classroom FAQ

What authentication is required?

You must set up authentication through the gws-shared skill, which handles Google Workspace credentials and security rules for all gws commands.

Can I create courses for other users?

Domain admins can create courses owned by any user in their domain. Non-admin users can only create courses with themselves as the owner.

How do I add students to a course?

Use the invitations resource to create an invitation for a user, then the invited user accepts it to be added as a student or teacher.

What is the difference between courseWork and courseWorkMaterials?

courseWork represents assignments and graded work, while courseWorkMaterials represents instructional materials and resources without grading.

How do I set up notifications for course changes?

Use the registrations resource to create a registration that sends Classroom notifications to a Cloud Pub/Sub topic.

Full instructions (SKILL.md)

Source of truth, from googleworkspace/cli.

name: gws-classroom description: "Google Classroom: Manage classes, rosters, and coursework." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws classroom --help"

classroom (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws classroom <resource> <method> [flags]

API Resources

courses

create — Creates a course. The user specified in ownerId is the owner of the created course and added as a teacher. A non-admin requesting user can only create a course with themselves as the owner. Domain admins can create courses owned by any user within their domain. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to create courses or for access errors. * NOT_FOUND if the primary teacher is not a valid user.
delete — Deletes a course. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to delete the requested course or for access errors. * NOT_FOUND if no course exists with the requested ID.
get — Returns a course. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to access the requested course or for access errors. * NOT_FOUND if no course exists with the requested ID.
getGradingPeriodSettings — Returns the grading period settings in a course. This method returns the following error codes: * PERMISSION_DENIED if the requesting user isn't permitted to access the grading period settings in the requested course or for access errors. * NOT_FOUND if the requested course does not exist.
list — Returns a list of courses that the requesting user is permitted to view, restricted to those that match the request. Returned courses are ordered by creation time, with the most recently created coming first. This method returns the following error codes: * PERMISSION_DENIED for access errors. * INVALID_ARGUMENT if the query argument is malformed. * NOT_FOUND if any users specified in the query arguments do not exist.
patch — Updates one or more fields in a course. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to modify the requested course or for access errors. * NOT_FOUND if no course exists with the requested ID. * INVALID_ARGUMENT if invalid fields are specified in the update mask or if no update mask is supplied.
update — Updates a course. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to modify the requested course or for access errors. * NOT_FOUND if no course exists with the requested ID. * FAILED_PRECONDITION for the following request errors: * CourseNotModifiable * CourseTitleCannotContainUrl
updateGradingPeriodSettings — Updates grading period settings of a course. Individual grading periods can be added, removed, or modified using this method. The requesting user and course owner must be eligible to modify Grading Periods. For details, see licensing requirements.
aliases — Operations on the 'aliases' resource
announcements — Operations on the 'announcements' resource
courseWork — Operations on the 'courseWork' resource
courseWorkMaterials — Operations on the 'courseWorkMaterials' resource
posts — Operations on the 'posts' resource
studentGroups — Operations on the 'studentGroups' resource
students — Operations on the 'students' resource
teachers — Operations on the 'teachers' resource
topics — Operations on the 'topics' resource

invitations

accept — Accepts an invitation, removing it and adding the invited user to the teachers or students (as appropriate) of the specified course. Only the invited user may accept an invitation. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to accept the requested invitation or for access errors.
create — Creates an invitation. Only one invitation for a user and course may exist at a time. Delete and re-create an invitation to make changes. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to create invitations for this course or for access errors. * NOT_FOUND if the course or the user does not exist. * FAILED_PRECONDITION: * if the requested user's account is disabled.
delete — Deletes an invitation. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to delete the requested invitation or for access errors. * NOT_FOUND if no invitation exists with the requested ID.
get — Returns an invitation. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to view the requested invitation or for access errors. * NOT_FOUND if no invitation exists with the requested ID.
list — Returns a list of invitations that the requesting user is permitted to view, restricted to those that match the list request. Note: At least one of user_id or course_id must be supplied. Both fields can be supplied. This method returns the following error codes: * PERMISSION_DENIED for access errors.

registrations

create — Creates a Registration, causing Classroom to start sending notifications from the provided feed to the destination provided in cloudPubSubTopic. Returns the created Registration. Currently, this will be the same as the argument, but with server-assigned fields such as expiry_time and id filled in. Note that any value specified for the expiry_time or id fields will be ignored.
delete — Deletes a Registration, causing Classroom to stop sending notifications for that Registration.

userProfiles

get — Returns a user profile. This method returns the following error codes: * PERMISSION_DENIED if the requesting user is not permitted to access this user profile, if no profile exists with the requested ID, or for access errors.
guardianInvitations — Operations on the 'guardianInvitations' resource
guardians — Operations on the 'guardians' resource

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws classroom --help

# Inspect a method's required params, types, and defaults
gws schema classroom.<resource>.<method>

Use gws schema output to build your --params and --json flags.