gws-classroom
Allows your agent to manage classes, rosters, and coursework in Google Classroom. It's useful for teachers and students.
What it does
This tool helps you manage classes, student lists, and assignments in Google Classroom. You can create, view, update, or delete classes and invitations.
When to use it
- ✓Creating a new class for a course.
- ✓Checking the student roster for a specific class.
- ✓Accepting an invitation to join a class.
Example of what to ask your AI
“Create a course named "Introduction to Programming" with the teacher "john.doe@school.com".”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The tool connects to Google Classroom to perform actions. You specify which class or invitation you want to manage and the action you want to take, such as create, view, or delete.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add googleworkspace/cli --skill gws-classroomOr download just the file:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-classroom/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
classroom (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws classroom <resource> <method> [flags]
API Resources
courses
create— Creates a course. The user specified inownerIdis 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_DENIEDif the requesting user is not permitted to create courses or for access errors. *NOT_FOUNDif the primary teacher is not a valid user.delete— Deletes a course. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to delete the requested course or for access errors. *NOT_FOUNDif no course exists with the requested ID.get— Returns a course. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to access the requested course or for access errors. *NOT_FOUNDif no course exists with the requested ID.getGradingPeriodSettings— Returns the grading period settings in a course. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user isn't permitted to access the grading period settings in the requested course or for access errors. *NOT_FOUNDif 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_DENIEDfor access errors. *INVALID_ARGUMENTif the query argument is malformed. *NOT_FOUNDif 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_DENIEDif the requesting user is not permitted to modify the requested course or for access errors. *NOT_FOUNDif no course exists with the requested ID. *INVALID_ARGUMENTif 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_DENIEDif the requesting user is not permitted to modify the requested course or for access errors. *NOT_FOUNDif no course exists with the requested ID. *FAILED_PRECONDITIONfor the following request errors: * CourseNotModifiable * CourseTitleCannotContainUrlupdateGradingPeriodSettings— 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' resourceannouncements— Operations on the 'announcements' resourcecourseWork— Operations on the 'courseWork' resourcecourseWorkMaterials— Operations on the 'courseWorkMaterials' resourceposts— Operations on the 'posts' resourcestudentGroups— Operations on the 'studentGroups' resourcestudents— Operations on the 'students' resourceteachers— Operations on the 'teachers' resourcetopics— 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_DENIEDif the requesting user is not permitted to accept the requested invitation or for access errors.
…
FAQ
How do I create a class?
You can use the 'create' command in the 'courses' section, specifying the class name and the teacher.
How do I see all my classes?
Use the 'list' command in the 'courses' section to see a list of classes you have access to.
Can I accept an invitation to a class?
Yes, use the 'accept' command in the 'invitations' section to accept an invitation you received.
Details
Original description by the author
Google Classroom: Manage classes, rosters, and coursework.
repo: googleworkspace/cli
Popularity
- GitHub stars
- 32k
- Ranking position
- #6256
- License
- Apache-2.0
- Updated
- 10/6/2026
Comments
- …
More skills from this repository
gws-admin-reports
Helps your agent get activity reports from Google Workspace. It collects audit and usage data.
googleworkspace/cli
gws-calendar-agenda
Helps your agent see upcoming events across all calendars. It's useful for organizing your schedule and knowing what's coming up.
googleworkspace/cli
gws-calendar-insert
Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.
googleworkspace/cli
gws-calendar
Allows your agent to manage calendars and events. It's useful for organizing your life and work.
googleworkspace/cli
Similar skills
architecture-decision-records
Has your agent record important project structure decisions. It helps to understand the reasoning behind choices and maintain a clear history of changes.
affaan-m/ECC
code-tour
Lets your agent create step-by-step code walkthroughs with exact file and line anchors. It's useful for project introductions, code explanations, or change reviews. Helps understand how a system works.
affaan-m/ECC
codebase-onboarding
Helps your agent analyze unfamiliar code and create an onboarding guide. It includes an architecture map, entry points, and conventions. Ideal for starting on a new project.
affaan-m/ECC