google-classroom-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CLASSROOM_OAUTH_PATH | Yes | Path to the Google Cloud OAuth 2.0 client credentials JSON file for a Desktop Application. | |
| CLASSROOM_CREDENTIALS_PATH | Yes | Path to the persisted OAuth credentials file containing the refresh token and access token (e.g., .classroom-server-credentials.json). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_coursesA | List courses where the user is a student or teacher (e.g. active or archived classes). |
| get_courseA | Get detailed information about a specific course by Course ID. |
| list_courseworkC | List assignments, quizzes, and coursework for a specific course. |
| get_courseworkA | Get detailed information for a specific assignment, including description, attached Drive files, YouTube links, and rubrics. |
| list_submissionsB | List student submissions for a coursework (status: TURNED_IN, RETURNED, NEW, late status, assigned grade). |
| get_submissionA | Get detailed student submission info including attached files, links, and assigned grade. |
| list_announcementsB | List stream announcements, notices, and updates for a course. |
| list_coursework_materialsA | List materials, syllabi, lecture slides, and resources posted under Classwork. |
| list_teachersA | List teachers of a course. |
| list_studentsB | List students enrolled in a course. |
| turn_in_assignmentC | Turn in a student submission for grading. |
| reclaim_assignmentB | Reclaim a turned-in student submission (unsubmit). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Each tool targets a distinct resource-action pair: courses, coursework, submissions, announcements, materials, and people are cleanly separated. The get/list pairs are unambiguous, and turn_in/reclaim are the only write actions with clearly opposite purposes.
All tools follow a consistent verb_noun snake_case pattern, using get_ or list_ for reads and action verbs for state changes. Pluralization is predictable based on whether the resource is a collection or an individual item.
12 tools is well within the ideal 3-15 range and each tool corresponds to a meaningful Google Classroom operation. The count feels appropriately scoped for a classroom-focused MCP without unnecessary bloat.
The server covers the main read workflows well: courses, coursework, submissions, announcements, materials, teachers, and students. It also supports the student-facing actions of turning in and reclaiming assignments, though it lacks create/update/delete operations for coursework or grading functionality.