How to integrate Google Classroom MCP with Grok Build

Connect Grok Build to Google Classroom MCP. List all active courses for this teacher, create a new announcement in math class, and more from your terminal, 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

How to integrate Google Classroom MCP with Grok Build

Grok Build is xAI's terminal coding agent. It runs on Grok 4.5, plans its work before it acts, and can run multiple sub-agents in parallel. It also reads Claude Code's MCP configuration, so any server you already have in a .mcp.json is picked up with no changes.

In this guide, I will show you how to connect your Google Classroom account to Grok Build through Composio, so it can list all active courses for this teacher, create a new announcement in math class, get details for course ID 12345, and more without leaving the terminal. Composio holds the OAuth tokens for you, and Grok Build only calls the tools you approve.

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

Also integrate Google Classroom with

Why use Composio over a standalone MCP server?

  • Read and write access. Composio's Google Classroom integration lets Grok Build take real actions like creating drafts, sending updates, and labeling records, not just reading data.
  • 1,700+ SaaS toolkits out of the box. One endpoint gives you a full catalog of pre-built connectors, from Gmail and Slack to Notion, Linear, and Salesforce.
  • One MCP server for every app. Wire up a single Composio server instead of maintaining a separate MCP entry for each app.
  • Smart, context-aware tool loading. Grok Build caps how many tools it holds in a single request. Composio loads only the tools a task needs, so you do not spend that budget on tools you are not using.
  • Cross-app automation. Chain actions across apps in one run. Pull a thread, summarize it in Notion, and post the highlights to Slack from a single prompt.

Prerequisites

  • Grok Build installed and signed in. Install with curl -fsSL https://x.ai/cli/install.sh | bash on macOS or Linux, or irm https://x.ai/cli/install.ps1 | iex on Windows PowerShell. On first launch Grok opens a browser to authenticate; for headless or CI use, set an XAI_API_KEY environment variable instead (create the key at console.x.ai).
  • Access to the Google Classroom account you want to connect.
  • The Composio MCP endpoint. Composio's server is remote and hosted, so there is nothing to run locally and no tunnel to set up.

Step-by-step: Connect Google Classroom to Grok Build

1. Install and verify Grok Build

Install the CLI, then restart your shell so the grok binary lands on your PATH:

bash
curl -fsSL https://x.ai/cli/install.sh | bash
which grok

On Windows, install with PowerShell instead: irm https://x.ai/cli/install.ps1 | iex. If which grok returns a path, you are set. Grok Build runs on Grok 4.5 by default; you can switch models inside the session with /model <name>.

2. Add the Composio server

Add Composio as a remote HTTP MCP server with the grok mcp add command:

bash
grok mcp add --transport http composio https://connect.composio.dev/mcp

You can also add and manage servers from inside a session. Run /mcps to open the extensions modal on the MCP tab, then add a new server and paste the Composio URL. Added this way, Grok auto-detects the name from the URL and lists the server as connect:

bash
https://connect.composio.dev/mcp
Grok Build /mcps extensions modal listing MCP servers Grok Build adding the Composio MCP server with its URL

Grok also reads Claude Code-style config, so an entry in ~/.grok/config.toml or a project .mcp.json works the same way.

3. Authenticate

Composio uses OAuth. In the /mcps modal, select the Composio server and press i to authenticate (Grok also triggers this browser flow automatically the first time it uses a Composio tool). Click Allow to authorize access. Grok stores the tokens under ~/.grok/mcp_credentials.json, and /mcps shows Composio as connected.

Grok Build prompting to authenticate the Composio MCP server Composio authorization screen with the Allow button for Grok Build

4. Start building

Ask Grok to work with your Google Classroom account through Composio. On the first Google Classroom action, Composio prompts you to connect the account through OAuth. Approve the scopes once, and Composio handles token refresh from there.

What you can do after connecting Google Classroom

  • List all active courses for this teacher
  • Create a new announcement in math class
  • Get details for course ID 12345
  • Delete the announcement about homework due

Security + privacy notes (important)

  • Use least-privilege access. Grant only the Google Classroom scopes you actually need.
  • Review OAuth scopes before approving. Check that the requested scopes match what you expect Composio and Grok Build to do.
  • Keep write actions human-reviewed. Grok Build proposes a plan before it acts. Leave that approval step on for actions like sending messages or editing records.
  • Keep secrets out of version control. Your XAI_API_KEY and any tokens should never be committed. Use environment variables or a secrets manager.
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