dsh-google-classroom
Google Classroom tools for DeepSeek Harness,
served by the google-classroom-mcp
server. Once installed, the model sees read-only tools such as
mcp__google-classroom__list_courses and mcp__google-classroom__list_due_soon.
This is a configuration-only DSH bundle: a package.json with a
dsh.bundle.patch and a cordis.patch.yml that inserts one
@deepseek-ai/dsh-mcp-client row. It ships no Host or Client code.
Prerequisites
- A Google OAuth client for the Classroom API. Follow
Google Classroom MCP — Setup
steps 1–3: create an OAuth desktop client, save it as
~/.google-classroom-mcp/client_secret.json, and run the one-time sign-in
(uvx --from git+https://github.com/praisethefacts/google-classroom-mcp@v0.1.0 google-classroom-mcp-auth).
- uv (provides
uvx). Install from
astral.sh/uv or
pip install uv. The bundle uses uvx to fetch and run the server on
demand, so no separate pip install is needed.
Install
In DeepSeek Harness, open Plugins in the sidebar and enter one of these
specs, then finish with Enable now:
github:praisethefacts/dsh-plugin-google-classroom — straight from GitHub- an absolute path to this directory, if you cloned it
Or from a terminal:
dsh plugin --profile <profile> add github:praisethefacts/dsh-plugin-google-classroom
Replace <profile> with your profile name (for example web or desktop).
Verify
Ask the model something like "What do I have due this week?" or call
mcp__google-classroom__list_courses. The first tool call may be slow while
uvx downloads the server and its dependencies; later calls are fast.
If every tool call returns
No valid Google credentials found..., the one-time sign-in has not run yet —
see Prerequisites. Google API errors naming scopes mean the OAuth consent
screen was not authorized with the read-only Classroom scopes; delete
~/.google-classroom-mcp/token.json and sign in again.
Configuration
The default row runs:
uvx --from git+https://github.com/praisethefacts/google-classroom-mcp@v0.1.0 google-classroom-mcp
To use a preinstalled or locally cloned server instead, edit
cordis.patch.yml before installing and change command/args:
- insert:
- id: mcp-google-classroom
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: google-classroom
transport: stdio
command: google-classroom-mcp
DSH scrubs ambient variables whose names look like credentials
(KEY, PASSWORD, SECRET, TOKEN) before launching stdio children, so
this bundle relies on the token files under ~/.google-classroom-mcp/, never
on environment variables.
Tools
All tools are read-only:
| Tool | Returns |
|---|
list_courses | Courses you teach or attend |
get_course | One course with description and enrollment code |
list_coursework | Assignments, quizzes, questions and materials, with due dates |
list_due_soon | Upcoming coursework across all active courses |
list_announcements | Recent announcements in a course |
list_teachers / list_students | Rosters (name, email) |
list_submissions | Submission state and grades for one assignment |
Development
npm install
npm test
The tests parse cordis.patch.yml and check the bundle declaration without a
running harness.
License
MIT
