Google Classroom MCP for students MCP server

Google Classroom MCP for students

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

This is a free, open source MCP server. It lets Claude, ChatGPT, Cursor and other AI apps read your Classroom classes, assignments, grades on returned work and announcements. 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.

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.

1. Add them to your AI app's MCP config (for Claude Desktop that's claudedesktopconfig.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"
      }
    }
  }
}

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 GOOGLEACCESSTOKEN to a token from the OAuth Playground with the Classroom read only scopes. It stops working after about an hour.

What you can ask

• "What do I still need to turn in?"
• "What's overdue?"
• "What's due this week across all my classes?"
• "What did my teachers post lately?"

Tools

All tools are read only.

Google Classroom has no overall course grade, so getmygrades adds up graded work only and says so.

Privacy and security

• Your credentials stay on your computer and are only sent to Google.
• Nothing is sent to any other server by this project.
• Only read only permissions are requested. Remove access any time at myaccount.google.com/permissions.

Troubleshooting

Development

npm install
npm run build
npm test

Tests run against a fake Google server, so they need no account or network.

Also available

• Brightspace MCP for D2L Brightspace, with a hosted version, deadline alerts and a daily digest.

License

MIT