Classroom Suite MCP

by anasdevai

333 downloads
Not rated
GitHub

About

Unified MCP server for Google Workspace. Manage Google Classroom courses/assignments, Google Drive files, and Google Docs directly from Claude. Features 17 tools including file uploads, assignment submissions, and PDF export.

Details

Author
anasdevai
Downloads
333
Categories
Other, Productivity, Automation

- Integrates Google Classroom, Drive, and Docs.
- List courses, get assignments, manage submissions.
- Search files, upload/download content, manage folders.
- Create docs, read content, export to PDF.
- Uses official Google OAuth 2.0 authentication.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Classroom Suite MCP
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Run uvx classroom-suite-mcp after installing the uv package manager. The server uses official Google OAuth 2.0 with granular scopes for authentication.

list_courses

List all courses the authenticated user is enrolled in. Args: page_size: Maximum number of courses to return (default: 20) course_states: Comma-separated states: ACTIVE, ARCHIVED, PROVISIONED, DECLINED, SUSPENDED Returns: List of courses with id, name, section, and state

get_course

Get detailed information about a specific course. Args: course_id: The ID of the course to retrieve Returns: Course details including name, description, and links

list_assignments

List all assignments for a specific course. Args: course_id: The ID of the course page_size: Maximum number of assignments to return Returns: List of assignments with id, title, due date, and points

get_assignment

Get detailed information about a specific assignment. Args: course_id: The ID of the course assignment_id: The ID of the assignment Returns: Assignment details including description, materials, and due date

list_submissions

List all submissions for an assignment. Args: course_id: The ID of the course assignment_id: The ID of the assignment page_size: Maximum number of submissions to return states: Comma-separated states: NEW, CREATED, TURNED_IN, RETURNED Returns: List of submissions with state, grade, and links

submit_assignment

Submit work to an assignment. Args: course_id: The ID of the course assignment_id: The ID of the assignment submission_id: The ID of your student submission drive_file_ids: Comma-separated Google Drive file IDs to attach link_urls: Comma-separated URLs to attach as links Returns: Updated submission with state and timestamp

list_files

List files and folders in Google Drive. Args: folder_id: ID of folder to list (None for all files) page_size: Maximum number of files to return file_type: Filter by MIME type (e.g., "application/pdf") Returns: List of files with id, name, type, and links

search_files

Search for files by name or content. Args: query: Search query string page_size: Maximum number of results Returns: List of matching files

create_folder

Create a new folder in Google Drive. Args: name: Name of the folder parent_id: ID of parent folder (None for root) Returns: Created folder with id and link

upload_file

Upload a file to Google Drive. Args: name: Filename content: File content (text or base64 for binary) mime_type: MIME type of the file parent_id: Parent folder ID is_base64: True if content is base64-encoded Returns: Uploaded file with id and link

download_file

Download a file from Google Drive. Args: file_id: ID of the file as_base64: Return content as base64 (for binary) Returns: File with id, name, and content

share_file

Share a file with users or make it public. Args: file_id: ID of the file to share email: Email address to share with role: Permission level (reader, writer, commenter) anyone: Make accessible to anyone with link Returns: File link after sharing

delete_file

Delete a file (move to trash or permanent). Args: file_id: ID of the file permanent: Permanently delete if True Returns: Deletion confirmation

create_doc

Create a new Google Doc. Args: title: Document title content: Optional initial text content folder_id: Folder to create the doc in Returns: Document with id, title, and link

read_doc

Read the content of a Google Doc. Args: document_id: ID of the document Returns: Document with id, title, and text content

update_doc

Update content in a Google Doc. Args: document_id: ID of the document text: Text to add mode: "append" (end), "prepend" (start), or "replace" Returns: Update confirmation

export_pdf

Export a Google Doc as PDF. Args: document_id: ID of the document Returns: PDF as base64 with filename and size

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "classroom suite mcp": {
            "classroom-suite-mcp": {
                "command": "uvx",
                "args": [
                    "classroom-suite-mcp"
                ],
                "env": {
                    "GOOGLE_CREDENTIALS_PATH": "C:/path/to/credentials.json",
                    "GOOGLE_TOKEN_PATH": "C:/path/to/token.json"
                }
            }
        }
    }
}

McpServers

{
    "classroom-suite-mcp": {
        "command": "uvx",
        "args": [
            "classroom-suite-mcp"
        ],
        "env": {
            "GOOGLE_CREDENTIALS_PATH": "C:/path/to/credentials.json",
            "GOOGLE_TOKEN_PATH": "C:/path/to/token.json"
        }
    }
}

Classroom Suite MCP

A production-ready MCP server that unifies Google Classroom, Google Drive, and Google Docs into a single, secure integration for AI assistants.

✨ Features

- Google Classroom: List courses, get assignments, manage submissions. - Google Drive: Search files, upload/download content, manage folders. - Google Docs: Create docs, read content, export to PDF. - Secure: Uses official Google OAuth 2.0 with granular scopes.

🚀 Quick Start

```bash uvx classroom-suite-mcp
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.