Skip to main content
Glama

Google Classroom MCP Server

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
  1. 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"] } }
  1. 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.

  1. 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
  2. Get details for my Math course with ID 123456789
  3. Show me all assignments for my History course with ID 987654321

Permissions

The server requests the following Google Classroom API permissions:

  • classroom.courses.readonly - To access course information
  • classroom.announcements.readonly - To access course announcements
  • classroom.coursework.me.readonly - To access your coursework and assignments
  • classroom.rosters.readonly - To access class rosters

Troubleshooting

If you encounter permission errors, try:

  1. Running the auth command again to refresh permissions:
    node index.js auth
  2. Ensuring your Google account is added as a test user in the Google Cloud Console if your app is in testing mode
  3. Checking the OAuth scopes in the authenticateAndSaveCredentials function to ensure they match your needs

Notes

  • This server is designed to be used with Claude AI or other MCP-compatible assistants
  • All API requests are made using your authenticated Google account
  • Token refresh is handled automatically by the server
  • Sensitive credentials are stored locally in the tokens.json file
-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

An MCP server that enables AI assistants to access and interact with Google Classroom data, allowing users to view courses, course details, and assignments through natural language commands.

  1. Setup
    1. Prerequisites
    2. Installation
  2. Usage
    1. Available Tools
    2. Example Prompts for Claude
  3. Permissions
    1. Troubleshooting
      1. Notes

        Related MCP Servers

        • -
          security
          F
          license
          -
          quality
          MCP server that enables AI assistants to perform SEO automation tasks including keyword research, SERP analysis, and competitor analysis through Google Ads API integration.
          Last updated -
        • -
          security
          F
          license
          -
          quality
          An MCP server that provides access to Google's API Discovery Service, allowing agents to discover and interact with Google APIs through natural language commands.
          Last updated -
          Python
          • Linux
          • Apple
        • -
          security
          F
          license
          -
          quality
          An MCP (Multi-Agent Conversation Protocol) Server that provides a standardized interface for interacting with Google's Cloud Vision API, enabling AI agents to analyze images and extract visual information through natural language.
          Last updated -
          Python
        • -
          security
          F
          license
          -
          quality
          This MCP Server provides a natural language interface to interact with Google's Policy Analyzer API, allowing users to analyze policies and evaluate compliance through conversations.
          Last updated -
          Python
          • Linux
          • Apple

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/faizan45640/google-classroom-mcp-server'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server