Google Classroom MCP Server

An MCP (Model Context Protocol) server that provides access to Google Classroom data through Claude and other AI assistants that support the MCP protocol.

Setup

Prerequisites

• Node.js (v16 or higher)
• A Google Cloud Platform project with the Google Classroom API enabled
• OAuth 2.0 client credentials for the Google Classroom API

Installation

Installing via Smithery

To install Google Classroom MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @faizan45640/google-classroom-mcp-server --client claude

Installing Manually

1. Clone this repository
2. Install dependencies:

npm install

3. Place your Google OAuth client credentials in a file named credentials.json in the project root:

{
  "web": {
    "client_id": "YOUR_CLIENT_ID",
    "project_id": "YOUR_PROJECT_ID",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uris": ["http://localhost:3000/auth/google/callback"]
  }
}

4. Authenticate with Google:

node index.js auth

This will launch a browser window to complete the OAuth flow and save your credentials to tokens.json.

5. Configure Claude to use this server by updating claude_desktop_config.json (typically in %APPDATA%\Claude\):

{
  "mcpServers": {
    "class": {
      "command": "node",
      "args": [
        "PATH_TO_YOUR_DIRECTORY\\index.js"
      ]
    }
  }
}

Usage

Available Tools

The server provides several tools for interacting with Google Classroom:

1. courses - List all your Google Classroom courses

Use the 'courses' tool to get a list of all your Google Classroom courses

2. course-details - Get detailed information about a specific course

Use the 'course-details' tool with the courseId parameter to get details and announcements for a specific course

Parameters:

• courseId: The ID of the course (can be obtained from the courses tool)

3. assignments - Get assignments for a specific course

Use the 'assignments' tool with the courseId parameter to get assignments and your submissions for a specific course

Parameters:

• courseId: The ID of the course (can be obtained from the courses tool)

Example Prompts for Claude

1. Show me all my Google Classroom courses