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.

Google Classroom MCP