How to integrate Google Classroom MCP with Codex

Connect Codex to Google Classroom MCP. List all active courses for this teacher, create a new announcement in math class, and more using natural language, with authentication handled for you.

Google Classroom logoGoogle Classroom
Oauth2

Google Classroom is a free web service for educators and students to manage assignments and communication. It streamlines classroom collaboration and grading, making teaching simpler and more connected.

100 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With the Google Classroom MCP integration, Codex can create and manage courses, post announcements, create coursework and materials, manage students and teachers, and review submissions, all without leaving the terminal or the app, whichever you prefer.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Google Classroom with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1700+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Google Classroom MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

Try it

Ask Codex for a Google Classroom task. The first time, Composio asks you to connect your Google Classroom account.

For example, ask it to:

  • "List all active courses for this teacher"
  • "Create a new announcement in math class"
  • "Get details for course ID 12345"

What is the Google Classroom MCP server, and what's possible with it?

The Google Classroom MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Google Classroom account. It provides structured and secure access to your classes, assignments, and announcements, so your agent can list courses, manage announcements, create coursework, and handle classroom organization on your behalf.

  • Course and class management: Effortlessly create, list, or delete courses, and get detailed information about any class you manage or attend.
  • Announcement automation: Let your agent create, update, list, or remove announcements in specific courses—keeping students and teachers in the loop.
  • Coursework material handling: Quickly list all coursework materials in a class, so you can track resources and assignments with ease.
  • Streamlined assignment workflows: Organize and distribute assignments and resources, helping automate typical classroom tasks for educators and students.
  • Classroom insights retrieval: Fetch up-to-date details about classes and their structure, enabling your agent to provide summaries or help with enrollment decisions.

Conclusion

You've successfully integrated Google Classroom with Codex using Composio's MCP server. Now you can interact with Google Classroom directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Google Classroom operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1700+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Google Classroom operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

Every Google Classroom action and event your agent gets out of the box.

Accept Invitation

Accept an invitation as the invited user, joining its course as a teacher or student.

Add Course Teacher

Directly add a teacher to a course as a domain administrator.

Add Student Group Member

Add a student to an existing student group in a course.

Create Course Alias

Tool to create an alias for a course.

Delete Course Alias

Tool to delete an alias of a course.

List Course Aliases

List a page of aliases for a specified course, with optional page size and page token.

Create Announcement

Tool to create an announcement in a course.

Delete Announcement

Tool to delete an announcement.

Get Announcement

Tool to get an announcement.

Get Add-on Context for Announcement

Tool to get metadata for Classroom add-ons in the context of a specific announcement post.

List Announcements

Tool to list announcements in a course.

Modify Announcement Assignees

Tool to modify assignee mode and options of an announcement.

Patch Announcement

Tool to update fields of an announcement.

Delete Add-on Attachment

Tool to delete an add-on attachment from a course announcement.

Get Add-on Attachment

Tool to get an add-on attachment from an announcement.

List Add-on Attachments

Lists a page of add-on attachments under an announcement.

Delete Add-on Attachment

Tool to delete an add-on attachment from course work.

Get Add-on Context for Course Work

Tool to get metadata for Classroom add-ons in the context of a specific course work.

List Add-on Attachments on Course Work Material

Tool to list all add-on attachments under a course work material post.

Delete Course Work Material

Tool to delete a course work material.

Modify CourseWork Assignees

Tool to modify assignee mode and options of coursework.

Patch Course Work

Tool to update one or more fields of a course work.

List Course Work Rubrics

Tool to list rubrics for a specific coursework.

Create Course

Tool to create a new course.

Delete Course

Tool to delete a course.

Get Course

Tool to get details for a specific course.

Get Grading Period Settings

Tool to retrieve grading period settings for a course.

List Courses

Tool to list all courses accessible to the authenticated user.

Patch Course

Tool to update one or more fields of a Classroom course.

List Post Add-on Attachments

Tool to list all add-on attachments created under a post.

Get Add-on Context for Post

Tool to get metadata for Classroom add-ons in the context of a specific post.

Add Student to Course

Tool to add a student to a course.

Delete Course Student

Tool to delete a student from a course.

Get Course Student

Tool to retrieve a specific student of a course.

List Student Guardians

Tool to list guardians of a student in a course.

List Course Students

Tool to list students in a course.

Delete Course Teacher

Tool to delete a teacher from a course.

Get Teacher

Tool to get teacher enrollment.

List Course Teachers

Tool to list teachers in a course.

Create Course Topic

Tool to create a course topic.

Delete Course Topic

Tool to delete a course topic.

Get Course Topic

Tool to get a course topic.

List Course Topics

Tool to list topics in a course.

Patch Course Topic

Tool to update fields of a course topic.

Update Course

Tool to update a course.

Patch Course Work Material

Tool to update fields of a course work material.

Create CourseWork

Tool to create a CourseWork item in a course.

Delete CourseWork

Tool to delete a specific CourseWork.

Get CourseWork

Tool to get details of a specific coursework.

List CourseWork

Tool to list coursework in a course.

Create Course Work Material

Tool to create course work material.

Get Coursework Material

Tool to get a coursework material.

List CourseWorkMaterials

Tool to list course work materials in a course.

List Student Submissions

Tool to list student submissions for a specific coursework.

Reclaim Student Submission

Tool to reclaim a student submission for editing.

Create Announcement Add-on Attachment

Create an add-on attachment on an announcement.

Create Coursework Add-on Attachment

Create an add-on attachment on course work.

Create Material Add-on Attachment

Create an add-on attachment on a course work material.

Create Rubric

Create a rubric for course work using criteria or a formatted spreadsheet.

Create Student Group

Create a student group for a course.

Delete Material Add-on Attachment

Delete an add-on attachment from a course work material using its identifiers.

Delete Registration

Delete a notification registration, stopping Classroom notifications for it.

Delete Rubric

Delete a rubric before grading has started using its course and work IDs.

Delete Student Group

Delete a student group from a course using its course and student group IDs.

Delete Student Guardian

Delete a student's guardian to stop their guardian notifications.

Get Add-on Attachment Submission

Retrieve a student's submission for a course work add-on attachment using the course, course work, attachment, and submission IDs.

Get CourseWork Add-on Attachment

Tool to get an add-on attachment from course work.

Get Add-on Context for Course Work Material

Tool to get metadata for Classroom add-ons in the context of a specific course work material.

Get Guardian Invitation

Retrieve a specific guardian invitation for a student by invitation ID.

Get Material Add-on Attachment

Retrieve an add-on attachment on a course work material by its IDs.

Get Rubric

Retrieve a rubric's criteria, scoring levels, and timestamps using its course, course work, and rubric IDs.

Get Student Guardian

Retrieve a specific guardian relationship for a student using the guardian ID.

Get Student Submission

Retrieve one student's submission by course, course work, and submission ID, including available answers, attachments, grades, and history.

Create Invitation

Tool to create an invitation for a user to a course.

Delete Invitation

Tool to delete an invitation.

Get Invitation

Tool to retrieve an invitation by its identifier.

List Invitations

Tool to list invitations that the requesting user is permitted to view.

Invite Student Guardian

Invite a student's guardian by email to receive guardian notifications.

List Add-on Attachment Submissions

List one page of student submissions the requester may view for a course work add-on attachment.

List Course Student Groups

Tool to list student groups in a course.

List CourseWork Add-on Attachments

Tool to list all add-on attachments created by an add-on under a course work.

List Guardian Invitations

List one page of guardian invitations for a student, or use studentId '-' as a domain administrator to list all accessible students' invitations.

List Student Group Members

List one page of students in a course's student group.

List Student Guardians

List one page of guardians for a student, or use studentId '-' as a domain administrator to list all accessible students' guardians.

Modify Student Submission Attachments

Add attachments to an ASSIGNMENT student submission and return the updated submission.

Create Registration

Tool to create a registration for push notifications from Google Classroom.

Remove Student Group Member

Remove a student from a specific student group using the course, group, and user IDs.

Return Student Submission

Return a student submission, transferring attached Drive files to the student.

Turn In Student Submission

Turn in a student submission, transferring attached Drive files to the teacher.

Update Add-on Attachment Submission

Update a student's add-on attachment grade on course work using a field mask.

Update Announcement Add-on Attachment

Update an add-on attachment on an announcement using a field mask.

Update Coursework Add-on Attachment

Update an add-on attachment on course work using a field mask.

Update Coursework Rubric

Update a course work rubric, replacing selected criteria or importing a spreadsheet.

Update Grading Period Settings

Update a course's grading period settings.

Update Material Add-on Attachment

Update an add-on attachment on a course work material using a field mask.

Update Rubric

Update a rubric by ID, replacing criteria or importing a formatted spreadsheet.

Update Student Group

Update a student group's title as a teacher using the required updateMask.

Update Student Submission

Update a student submission's draft or assigned grade as a teacher.

Get User Profile

Tool to retrieve a user profile by user ID.

Withdraw Guardian Invitation

Withdraw a pending guardian invitation by setting state to COMPLETE with updateMask=state.

FAQ

Frequently asked questions

Start with Google Classroom.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Google Classroom tool your agent needs.Free to start.

Start building