MCP Tools Reference: classroommcp.googleapis.com

Tool: list_course_work_summaries

Lists published assignments, questions, and materials in a course (not drafts or scheduled items). Use this to discover coursework items and retrieve their IDs. Set includeSubmissionOverview=true to also get aggregate submission counts (for teachers) or the caller's own submission status (for students).

For full details such as instructions, materials, and settings, use get_course_work.

To link the user to a coursework item in the Classroom web app, use https://classroom.google.com/c/{course_id}/{type}/{course_work_id}/details, where {type} is a for ASSIGNMENT, sa for SHORT_ANSWER_QUESTION, mc for MULTIPLE_CHOICE_QUESTION, or m for MATERIAL. Use IDs exactly as returned; never guess or modify them.

The following code sample shows how to use curl to call the list_course_work_summaries MCP tool.

Input Schema

{
  "courseId": string,
  "courseWorkType": enum (Type),
  "topicIds": [
    string
  ],
  "titleContains": string,
  "dueDateRange": {
    object (DateRange)
  },
  "publishDateRange": {
    object (DateRange)
  },
  "includeSubmissionOverview": boolean,
  "timeZone": string,
  "pageSize": integer,
  "pageToken": string
}

{
  "startDate": string,
  "endDate": string
}

Output Schema

{
  "courseWorkSummaries": [
    {
      object (CourseWorkSummary)
    }
  ],
  "nextPageToken": string
}

{
  "id": string,
  "courseWorkType": enum (Type),
  "topicId": string,
  "topicTitle": string,
  "title": string,
  "publishDate": string,
  "dueDate": string,

  "submissionSummary": {
    object (TeacherSubmissionSummary)
  },
  "submissionOverview": {
    object (StudentSubmissionOverview)
  }
}

{
  "turnedInCount": integer,
  "assignedCount": integer,
  "gradedCount": integer,
  "missingCount": integer,
  "lateTurnedInCount": integer,
  "returnedCount": integer,
  "excusedCount": integer
}

{
  "state": enum (State),

  "late": boolean

  "gradePercentage": number
}

Tool Annotations

Tool annotations are sent to MCP clients to describe the basic risk of a given tool. Most clients treat these hints as untrusted, but they can be used to decide when a confirmation prompt might be sent to a user.

Along with the title string, the following boolean hints are defined as follows:

• readOnlyHint: If true, the tool doesn't modify its environment. Default: false.
• destructiveHint: If true, then the tool can perform destructive actions. If false, then the tool can only perform additive actions. Default: true.
• idempotentHint: If true, then calling the tool repeatedly with the same arguments will have no additional effect on its environment. Default: false.
• openWorldHint: If true, then the tool can interact with an 'open world' of external entities. If false, then the tool can only interact with internal entities. For example, a web search tool would be open world, while a memory tool would not be open world.

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

Authorization Scopes

Requires one of the following OAuth scopes:

• https://www.googleapis.com/auth/classroom.coursework.students
• https://www.googleapis.com/auth/classroom.coursework.students.readonly
• https://www.googleapis.com/auth/classroom.coursework.me
• https://www.googleapis.com/auth/classroom.coursework.me.readonly
• https://www.googleapis.com/auth/classroom.topics
• https://www.googleapis.com/auth/classroom.topics.readonly