Log inSubmit server
Google Classroom Student MCP logo

Google Classroom Student MCP

Read-only Google Classroom access for courses, assignments, due dates, grades, announcements, materials, and student catch-up workflows.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Google Classroom Student MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "google-classroom-student-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "google-classroom-student-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "YOUR_VALUE_HERE",
        "GOOGLE_CLIENT_SECRET": "YOUR_VALUE_HERE",
        "GOOGLE_REFRESH_TOKEN": "YOUR_VALUE_HERE",
        "GOOGLE_ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "CLASSROOM_TIMEZONE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 14 tools correctly ().

Overview

google-classroom-student-mcp connects an MCP-compatible AI app to Google Classroom through the Classroom API, exposing read-only student data. Its tools cover courses, assignments, due dates, missing work, returned grades, teacher comments, announcements, materials, and course teachers. It can also calculate points needed for a target grade, create an ICS calendar, and produce a catch-up digest. Reach for it when students need to query several classes conversationally without giving the AI permission to submit, edit, or delete Classroom content.

Use cases

  • Find assignments that still need to be submitted
  • Check overdue and upcoming work across classes
  • Review grades and teacher comments
  • Calculate points needed to reach a target percentage
  • Export upcoming deadlines to an ICS calendar

Key features

  • Read-only Google Classroom access
  • Assignment, due-date, and missing-work queries
  • Grades, submission status, and teacher comments
  • ICS export for upcoming due dates
  • Announcements, materials, and teacher lookup
  • Catch-up digest across classes

Tools14

What Google Classroom Student MCP lets your agent do. Expand a tool for its parameters.

Verified live~3.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

What it can do

From the 14 tools this server returned when we ran it; 14 declare their own safety hints.

Makes network requests · 14Read-only tools · 14
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age29 days
Maintainers1

Observed 2026-11-13 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8h ago via OSV.dev · google-classroom-student-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads2.3kPackage downloads in the last 30 days.
Last commit12d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed14Callable tools this server registers over MCP.

How Google Classroom Student MCP works

What google-classroom-student-mcp does

google-classroom-student-mcp gives students a read-only way to query Google Classroom from an MCP-compatible AI application. It can inspect active classes, coursework, due dates, submission state, returned scores, teacher comments, announcements, course materials, and teachers whose email addresses Classroom shares.

The server is designed for questions such as what remains unsubmitted, what is overdue, what is due across classes, what a teacher wrote on returned work, and what has changed recently. It can also determine the points needed on remaining work to reach a target percentage and produce an ICS calendar file for upcoming due dates.

How it works

The server uses the Google Classroom API with OAuth credentials created in a Google Cloud project. After authorization, the AI app calls MCP tools, which read the student’s Classroom data and return formatted results in chat. Due times are stored by Classroom in UTC; the server displays them using the configured time zone or the time zone of the machine running the server.

Access is read-only. The server cannot turn in assignments, modify coursework, edit grades, or delete Classroom data. It is intended for a student’s own Google account and is not affiliated with Google.

Setup and configuration

Install or run the package through npx:

Terminal
npx google-classroom-student-mcp setup

Before connecting an AI app, create a Google Cloud project, enable the Google Classroom API, configure the OAuth consent screen with the account as a test user, and create a Desktop app OAuth client. Run the login command with the client ID and secret, approve read-only access, and save the resulting refresh token.

bash
GOOGLE_CLIENT_ID=your-id GOOGLE_CLIENT_SECRET=your-secret npx google-classroom-student-mcp login

Add the generated mcpServers configuration to the selected application and restart it. npx google-classroom-student-mcp doctor checks the setup. For a short-lived test, GOOGLE_ACCESS_TOKEN can be used with a token from Google’s OAuth Playground; such tokens expire after about an hour.

CLASSROOM_TIMEZONE accepts an IANA time zone such as America/Toronto. It controls how undetermined due times are interpreted and displayed.

Tools and capabilities

  • get_my_courses lists active classes and their IDs.
  • get_todo finds assignments not yet turned in.
  • get_upcoming_due_dates returns soon-due work in chronological order.
  • get_missing_assignments lists overdue, unsubmitted work.
  • get_assignments retrieves assignments for a class with due dates and status.
  • get_assignment_details returns descriptions, attachments, due dates, points, and status.
  • get_submission_status reports turn-in timing, lateness, grade, and teacher comments.
  • get_my_grades lists returned points and teacher comments by class.
  • get_target_grade estimates points needed to reach a target percentage.
  • export_due_dates_calendar creates an ICS calendar file.
  • get_announcements, get_course_materials, and get_course_teachers retrieve class information.
  • get_whats_new combines recent announcements, grades, overdue work, and upcoming deadlines into one digest.

Limitations and notes

Only read operations are supported. Assignments without a due date are handled separately from dated work, and due dates without a specified time are interpreted using the configured or local time zone. The server requires Google OAuth setup and Classroom API access before an AI client can use the tools.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Google Classroom Student MCP

google-classroom-student-mcp is an MCP server that connects AI applications to the Google Classroom API for read-only student access. Its main tools retrieve courses, assignments, due dates, missing work, grades, announcements, materials, and submission details, while also supporting target-grade calculations, calendar export, and catch-up summaries.

Install it through npx by running `npx google-classroom-student-mcp setup`. You must first enable the Google Classroom API, create a Desktop OAuth client, complete the one-time login, and add the generated MCP configuration to your AI application.

Authenticate with a Google Cloud OAuth client and a refresh token. Set `GOOGLE_CLIENT_ID` and `GOOGLE_CLIENT_SECRET`, run `npx google-classroom-student-mcp login`, approve read-only access, and place the resulting `GOOGLE_REFRESH_TOKEN` in the MCP client configuration.

Yes, google-classroom-student-mcp works with Cursor through `.cursor/mcp.json` or the user-level `~/.cursor/mcp.json` file. Configure it as an stdio server using `npx -y google-classroom-student-mcp` and provide the three Google OAuth environment variables.

No, google-classroom-student-mcp is read-only and cannot submit, edit, or delete Classroom content. Its tools can inspect assignment details, submission status, grades, comments, deadlines, announcements, and materials.

Related MCP servers

All in Education All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGoogle Classroom Student MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/google-classroom-student-mcp?style=directory)](https://allmcps.com/mcp/google-classroom-student-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/google-classroom-student-mcp"><img src="https://allmcps.com/api/badge/google-classroom-student-mcp?style=directory" alt="Google Classroom Student MCP on AllMCPs" /></a>