Google Classroom MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Google Classroom MCP or direct API to list classes, manage assignments, send announcements, and check student submissions through natural language.

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 ToolsManaged auth

Try Google Classroom now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Google Classroom
Try asking
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.

SETUP GUIDE

Connect Google Classroom MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["google_classroom"],
  mcp: true,
});
Create a session scoped to Google Classroom and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all coursework materials for my Algebra class",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Google Classroom request
SETUP GUIDE

Connect Google Classroom API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["google_classroom"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Google Classroom
3

Run Google Classroom tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all coursework materials for my Algebra class" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Google Classroom tool calls through the session, and print the final answer
Guide

Connect multiple Google Classroom accounts to Claude and tell it which one to use by name.

Read the guide

Why Use Composio?

AI Native Google Classroom Integration

  • Supports both Google Classroom MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Google Classroom data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Google Classroom access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Google Classroom
  • Scoped, least privilege access to Google Classroom resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
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