gws-classroom Skill for Claude Code: Manage Google Classroom Courses

Lets your assistant manage Google Classroom courses, rosters, invitations and coursework through the gws command.

Installs: 29.8K; on skills.sh
Stars: 32K; on GitHub
Updated: Oct 2026; last repo commit

gws-classroom teaches your assistant to run gws classroom <resource> <method>. It lists the courses resource (create, delete, get, list, patch, update, grading period settings, plus aliases, announcements, courseWork, students, teachers, topics and more), invitations, registrations and userProfiles.

It needs the gws command installed and signed in, and its first line tells the assistant to read the gws-shared skill for sign-in, global flags and security rules. Before a call it tells the assistant to browse gws classroom --help and inspect a method with gws schema classroom.<resource>.<method>. The folder holds one file, SKILL.md.

Good for

Teachers who want help with courses and rosters
School admins who manage many classes
Developers scripting Classroom from the terminal

Install gws-classroom

Claude Code

Copy this prompt.

Install the gws-classroom skill in Claude Code. Run this command:

npx skills add https://github.com/googleworkspace/cli

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 18+.

gws-classroom reads gws-shared first. The README's install-all command adds both. To take only gws-classroom, the README shows npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-classroom, but gws-shared is a separate folder. The skills CLI command in the README installs the whole gws set. Run gws auth setup once if you have gcloud; the README covers a manual OAuth setup if you do not. It also warns that an unverified OAuth app limits consent to about 25 scopes, so choose services with gws auth login -s drive,sheets for example.

From the project README. Source.

What's in the skill

When it loads

Google Classroom: Manage classes, rosters, and coursework.

Sections in SKILL.md

API Resources
courses
invitations
registrations
userProfiles
Discovering Commands

Key facts

Author: Google Workspace (googleworkspace/cli)
Repo: googleworkspace/cli
License: Apache-2.0 (repo)
Installs on skills.sh: 29,849 (Nov 2, 2026)
GitHub stars (whole repo): 32,038 (Nov 2, 2026)
Last repo commit: Oct 30, 2026
Skill folder: 1 file: SKILL.md
Skill version in SKILL.md: 0.22.5
Shared skill: gws-shared, for sign-in, global flags and security rules
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass

What it includes

Create, get, list, update or delete courses; create sets ownerId as teacher
Create, get, list, patch, update or delete courses, plus grading period settings. A non-admin can only create a course owned by themselves; domain admins can create courses owned by any user in their domain.
Delete · gws classroom courses
Work with announcements, courseWork, students, teachers, topics and more
Write · gws classroom courses <sub-resource>
Create, accept, get, list or delete invitations; one per user and course
Only one invitation per user and course can exist at a time, so delete and re-create to change one. Only the invited user may accept it. Listing needs a user_id or a course_id.
Delete · gws classroom invitations
Create or delete a notification registration for a Pub/Sub topic
Create a registration so Classroom sends notifications from a feed to a Cloud Pub/Sub topic you name, or delete it to stop them.
Delete · gws classroom registrations
Get a user profile, and manage guardians and guardian invitations
Write · gws classroom userProfiles
Browse the resources and methods before calling one
Read · gws classroom --help
Inspect a method's required parameters, types and defaults
Read · gws schema classroom.<resource>.<method>

From the official docs

Permissions

High risk

This skill can create, change and delete Classroom courses, rosters and invitations in your account. Choose narrow sign-in scopes and approve each write or delete yourself.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can delete courses and invitations
The courses and invitations resources include delete. The gws-shared skill says: Always confirm with user before executing write/delete commands. github.com
It handles student and guardian data
It reaches rosters, student profiles and guardian invitations. Check your school's rules before using an AI tool with that data. github.com
The gws CLI is not an official Google product
The README says so and warns of breaking changes before v1.0. Test on a spare account first. github.com

Technical details

Talks to	Google Classroom API through the gws command
Sign-in and keys	The README says gws auth login stores credentials encrypted with AES-256-GCM, with the key in your OS keyring or in ~/.config/gws/.encryption_key when the file backend is set.
Scopes	Google Classroom, through the scopes you pick at sign-in

Questions

What does gws-classroom do?

It teaches your assistant the gws classroom commands for courses, invitations, registrations and user profiles. The assistant runs them on your machine with your Google sign-in.

How do I install gws-classroom?

Use the install box at the top of this page. It installs the whole gws skill set, which includes gws-shared. You also need the gws command installed and signed in to Google.

Do I need the gws command line?

Yes. The frontmatter lists gws as a required binary, and every command in the file starts with gws. The README covers install options and Google sign-in, which uses a Google Cloud project for OAuth credentials.

Is gws an official Google tool?

The README says it is not an officially supported Google product, and that you should expect breaking changes before v1.0.

Who can create a course?

The file says a non-admin can only create a course with themselves as owner, and domain admins can create courses owned by any user in their domain. The ownerId user becomes the course owner and a teacher.

Can it delete courses or remove students?

Courses and invitations have a delete method in the file. Students and teachers are listed as resources without their methods, so check with gws schema before assuming what they allow. The gws-shared skill says: Always confirm with user before executing write/delete commands.

Is gws-classroom safe to install?

The skill is one markdown file. What matters is what gws can do with your Google account: it can change and delete Classroom data. Pick narrow scopes, approve each write, and try it on a test course first.

Information

updated Nov 2, 2026

Repository: googleworkspace/cli
Folder: skills/gws-classroom

googleworkspace/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4