Google Classroom MCP for students

Google Classroom MCP server for students

Ask your AI what's actually left to do in Google Classroom.

npx google-classroom-student-mcp setup

That one command prints the config for your AI app. Details are in Quick start with npx.

This is the Google Classroom MCP server: a free, open source MCP server that lets Claude Desktop, Claude Code, Cursor and other MCP apps read your Classroom classes, assignments, due dates, missing work, grades on returned work with the comments your teachers leave on them, the points you need to reach a target grade, announcements, course materials and a catch up digest. It is read only. It can never turn in, edit or delete anything. Not affiliated with Google.

Free forever. No sign up and no subscription. Your login details only ever go to Google.

Try it now

Ask these right after setup:

• "What do I still need to turn in?"
• "What's overdue?"
• "What's due this week across all my classes?"
• "What did my teacher say about my work?"
• "What do I need to score to get a 90?"
• "What's new since yesterday?"

Sample answer

The third question goes to get_upcoming_due_dates. It reads your classes and prints one line per assignment, soonest first. Here is what an answer looks like:

- Essay outline (English) due Fri, Oct 23

• Lab write up (Biology) due Fri, Oct 23, 11:59 p.m. UTC
• Problem set 4 (Calculus) due Mon, Oct 26

Every line has the assignment title, the class and the due date. Work you already turned in is left out. Pass days_ahead set to 7 to that tool for a week ahead. Classroom keeps due times in UTC, and the server prints them in your own time zone. More sample answers are in Questions students ask.

Quick start with npx

Install the Google Classroom MCP server with npx, then add it to your AI app. Run npx google-classroom-student-mcp setup to print the config blocks below, with the three Google values filled in when they are set in your environment. Pick your app.

Claude Desktop

Add this to claude_desktop_config.json:

{

"mcpServers": { "classroom": { "command": "npx", "args": ["-y", "google-classroom-student-mcp"], "env": { "GOOGLE_CLIENT_ID": "your-id", "GOOGLE_CLIENT_SECRET": "your-secret", "GOOGLE_REFRESH_TOKEN": "paste-from-login" } } } }

Claude Code

Run this one command:

claude mcp add google-classroom-student-mcp \

-e GOOGLE_CLIENT_ID=your-id \ -e GOOGLE_CLIENT_SECRET=your-secret \ -e GOOGLE_REFRESH_TOKEN=paste-from-login \ -- npx -y google-classroom-student-mcp

Or put the same JSON block as Claude Desktop in a .mcp.json file in your project folder, or run claude mcp add-json with it.

Cursor

Put this in .cursor/mcp.json in your project folder, or in ~/.cursor/mcp.json to use it everywhere:

{

"mcpServers": { "classroom": { "command": "npx", "args": ["-y", "google-classroom-student-mcp"], "env": { "GOOGLE_CLIENT_ID": "your-id", "GOOGLE_CLIENT_SECRET": "your-secret", "GOOGLE_REFRESH_TOKEN": "paste-from-login" } } } }

Other MCP apps take the same mcpServers JSON, with command set to npx and args set to ["-y", "google-classroom-student-mcp"].

Setup (about 10 minutes, one time)

Google makes every app ask for its own permission, so you create a small private "app" that only you use.

1. Go to the Google Cloud console and create a project.
2. Turn on the Google Classroom API for it (APIs & Services > Library).
3. Under APIs & Services > OAuth consent screen, set it up as External, and add your own Google account as a test user.
4. Under Credentials, create an OAuth client ID of type Desktop app. Copy the client ID and secret.
5. Run the one time sign in:

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

Open the link it prints, approve read only access, and copy the three values it prints.

Optional: set CLASSROOM_TIMEZONE to a time zone name such as America/Toronto. Work with a due date but no due time counts as due at the end of that day in this zone. Without it, the time zone of the computer running the server is used.

1. Add them to your AI app's MCP config. Run npx google-classroom-student-mcp setup and paste the block for your app, or use one of the formats from the Quick start above.

1. Restart your AI app and ask "what's due this week?"

Run npx google-classroom-student-mcp doctor any time to check that your setup works.

Quick test without the app setup: set GOOGLE_ACCESS_TOKEN to a token from the OAuth Playground with the Classroom read only scopes. It stops working after about an hour.

Questions students ask

Here are the questions students ask, and the tool that answers each one. The answer comes back in the chat, ready to read.

Here is what the answers look like.

Sample answer for get_todo

The question "What do I still need to turn in?" goes to get_todo. It prints everything you have not handed in, and it puts the Classroom page of each one under the title so you can open the work itself.

0 due today, 2 overdue

• Lab safety form (English) due Fri, Oct 9 link: https://classroom.google.com/c/English/course/1/courseWork/w2
• Chapter 3 questions (Biology) due Mon, Oct 19 link: https://classroom.google.com/c/Biology/course/2/courseWork/w4
• Essay outline (English) due Fri, Oct 23 link: https://classroom.google.com/c/English/course/1/courseWork/w1
• Lab write up (Biology) due Fri, Oct 23, 11:59 p.m. UTC link: https://classroom.google.com/c/Biology/course/2/courseWork/w3
• Problem set 4 (Calculus) due Mon, Oct 26 link: https://classroom.google.com/c/Calculus/course/3/courseWork/w5

The first line counts what is due today and what is overdue. Work you already turned in is left out, and work with no due date goes last. Pass course_ids to check a few classes only. You can also pass course_name, for example Biology, to pick a class by part of its name without looking up its ID first.

Sample answer for get_missing_assignments

The question "What's overdue?" goes to get_missing_assignments. It prints the work that was due and is still not handed in, the most recent due date first.

- Chapter 3 questions (Biology) was due Mon, Oct 19

• Lab safety form (English) was due Fri, Oct 9

Sample answer for get_whats_new

The question "What's new since yesterday?" goes to get_whats_new. It prints one digest with new announcements, new grades, overdue work and what is due next. The times in this sample are in UTC.

New announcements (last 7 days)

• Biology (Wed, Oct 21, 8:00 a.m. UTC) Field trip permission slip due Friday
• English (Tue, Oct 20, 9:00 a.m. UTC) Bring your textbook

New grades (last 7 days)

• Midterm review (Calculus) graded 88/100 on Tue, Oct 20, 3:00 p.m. UTC teacher said: Good work on the analysis. Watch the units on question 3. link: https://classroom.google.com/c/Calculus/course/3/courseWork/w6

Overdue work

• Chapter 3 questions (Biology) was due Mon, Oct 19
• Lab safety form (English) was due Fri, Oct 9

Due next (14 days)

• Essay outline (English) due Fri, Oct 23
• Lab write up (Biology) due Fri, Oct 23, 11:59 p.m. UTC
• Problem set 4 (Calculus) due Mon, Oct 26

Pass since_days to look further back and days_ahead to look further ahead.

Tools

All tools are read only.

The same list is in plain text in llms.txt, one line per tool with its description and the arguments it takes. That file ships with the package, so site indexes and AI apps that read plain text files can pick it up.

get_todo, get_assignments, get_assignment_details, get_announcements and get_course_materials print the Classroom page of each item under the title, so the AI can hand the student a direct link to the work. get_course_materials also prints the Drive link of every file attached to a material. Classroom sends a link only for published items.

Google Classroom has no overall course grade, so get_my_grades adds up graded work only and says so. When a class weights its work by grading category, it also prints a weighted percent, using only the categories that have graded work. get_target_grade still uses plain points.

get_my_grades and get_whats_new print what the teacher wrote when they returned the work, under the score, with the Classroom page of the work. get_my_grades lists the graded work that has a comment under each class.

get_todo, export_due_dates_calendar, get_upcoming_due_dates, get_missing_assignments, `get_my_grades