MCP 服务器

Google Classroom MCP

This MCP server provides comprehensive read and write access to Google Classroom, enabling management of courses, rosters, assignments, and grades. It supports full lifecycle operations for educational environments including student submissions, teacher invitations, and coursework organization.

README

Google Classroom MCP (local)

This MCP server exposes multiple tools for read + write:

classroom_get_user_enrollments
classroom_get_course
classroom_list_courses
classroom_create_course
classroom_update_course
classroom_set_course_state
classroom_archive_course
classroom_activate_course
classroom_delete_course
classroom_list_course_students
classroom_list_course_teachers
classroom_add_teacher_to_course
classroom_remove_teacher_from_course
classroom_add_student_to_course
classroom_remove_student_from_course
classroom_list_invitations
classroom_get_invitation
classroom_create_invitation
classroom_delete_invitation
classroom_accept_invitation
classroom_list_course_topics
classroom_create_topic
classroom_create_announcement
classroom_list_coursework
classroom_create_assignment
classroom_list_student_submissions
classroom_set_draft_grade
classroom_set_assigned_grade
classroom_turn_in_submission
classroom_reclaim_submission
classroom_return_submission

1) Google Workspace setup

Create (or choose) a Google Cloud project.
Enable Google Classroom API.
Create a Service Account and download its JSON key.
Enable Domain-wide delegation on that service account.
In Google Admin Console, go to Security > API controls > Domain-wide delegation and add:
- Client ID: service account client ID
- OAuth scopes (comma-separated):
  - https://www.googleapis.com/auth/classroom.courses.readonly
  - https://www.googleapis.com/auth/classroom.courses
  - https://www.googleapis.com/auth/classroom.rosters.readonly
  - https://www.googleapis.com/auth/classroom.rosters
  - https://www.googleapis.com/auth/classroom.topics.readonly
  - https://www.googleapis.com/auth/classroom.topics
  - https://www.googleapis.com/auth/classroom.announcements
  - https://www.googleapis.com/auth/classroom.coursework.students.readonly
  - https://www.googleapis.com/auth/classroom.coursework.students
  - https://www.googleapis.com/auth/classroom.coursework.me
Ensure the delegated admin user can read Classroom data in your domain.

2) Local install

cd /home/carlos/classroom-mcp
bash setup.sh
cp .env.example .env
# edit .env

3) Register in Codex

codex mcp add classroom -- /home/carlos/classroom-mcp/run.sh
codex mcp list

4) Example prompt in Codex

En qué materias está registrado el usuario guiarodrigo@asociacionmontessori.mx?

5) Smoke test (portable)

Run the full write-path smoke test with automatic cleanup:

cd /home/carlos/classroom-mcp
./smoke_test.sh

You can override inputs with flags:

./smoke_test.sh \
  --teacher-email carlos@certificacionmontessori.com \
  --student-email carlos@asociacionmontessori.com.mx \
  --course-id 765463029199

Or set defaults in .env:

SMOKE_TEST_TEACHER_EMAIL
SMOKE_TEST_STUDENT_EMAIL
SMOKE_TEST_COURSE_ID

Keep generated artifacts (no cleanup) only when debugging:

./smoke_test.sh --keep-artifacts

6) Admin smoke test (course lifecycle + invitations)

This covers the newer admin tools:

create/update/archive/activate/delete course
add/remove teacher
create/get/list/accept/delete invitation

cd /home/carlos/classroom-mcp
./admin_smoke_test.sh

With explicit inputs:

./admin_smoke_test.sh \
  --admin-email admin@asociacionmontessori.com.mx \
  --teacher-email carlos@certificacionmontessori.com \
  --student-email carlos@asociacionmontessori.com.mx

Defaults can live in .env:

ADMIN_SMOKE_ADMIN_EMAIL
ADMIN_SMOKE_TEACHER_EMAIL
ADMIN_SMOKE_STUDENT_EMAIL

Notes

If the user exists outside your Workspace domain, Google may return 403/404.
If you need archived courses too, ask with course_state="ARCHIVED".
acting_user_email lets you impersonate a teacher/admin for operations that require role-specific permissions.
classroom_create_announcement does not support real Classroom topic binding; if topic_id is sent, it is appended as text marker.
classroom_create_course defaults to PROVISIONED for safer setup before going live.
classroom_create_course defaults ownerId to acting_user_email (or GOOGLE_WORKSPACE_ADMIN_EMAIL) when not provided.
classroom_delete_course permanently deletes the course; prefer classroom_archive_course when in doubt.