Google Classroom MCP Server

🚀 Google Classroom MCP Server

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

🚀 Quick Start

✨ Features

• This server offers multiple tools to interact with Google Classroom, including listing courses, getting course details, and retrieving assignments.
• It supports both automatic installation via Smithery and manual installation.
• Allows configuration for use with Claude Desktop.

📦 Installation

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

Automatic Installation via Smithery

Automatically install the Google Classroom MCP Server for Claude Desktop through Smithery:

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

Manual Installation

1. Clone this repository.
2. Install dependencies:

npm install

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

{
  "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 open a browser window to complete the OAuth flow and save the credentials to tokens.json. 5. Configure Claude to use this server by updating the claude_desktop_config.json file in %APPDATA%\Claude\:

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

💻 Usage Examples

Basic Usage

The server provides several tools to interact 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 and provide the courseId parameter to get detailed information and announcements for a specific course.

Parameters:

• courseId: The course ID (obtainable from the courses tool)

3. assignments - Get assignments for a specific course

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

Parameters:

• courseId: The course ID (obtainable from the courses tool)

Example prompts for Claude

1. Show all my Google Classroom courses.
2. Get the details of the Math course (ID 123456789).
3. Show the due dates for assignments in the Physics course.

Permissions

• Read all courses: Allows access to all courses you've created or joined.
• Write permissions: Allows publishing and managing content in courses.

Example

{
  "permissions": {
    "read": ["courses"],
    "write": ["courses"]
  }
}

Troubleshooting

1. Ensure you've correctly configured the environment variables.
2. Check your network connection to ensure access to the Google Classroom API.
3. If you still encounter issues, rerun the authentication process:

node index.js auth

This MCP server provides a powerful and flexible tool for interacting with Google Classroom.