Skip to content
Skillpedia
Documentation32k · #6256

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

https://github.com/googleworkspace/cli/blob/main/skills/gws-classroom/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/googleworkspace/cli/blob/main/skills/gws-classroom/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
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-classroom

Or download just the file:

curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-classroom/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

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.

…

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

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills