Google Classroom MCP Server

Integrations

  • Provides access to Google Classroom data, allowing users to list courses, get course details and announcements, and retrieve assignments and submissions from their Google Classroom account.

Google Classroom MCP サーバー

Claude や MCP プロトコルをサポートするその他の AI アシスタントを通じて Google Classroom データへのアクセスを提供する MCP (Model Context Protocol) サーバー。

設定

前提条件

  • Node.js (v16 以上)
  • Google Classroom API が有効になっている Google Cloud Platform プロジェクト
  • Google Classroom API の OAuth 2.0 クライアント認証情報

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Google Classroom MCP サーバーを自動的にインストールするには:

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

手動でインストールする

  1. このリポジトリをクローンする
  2. 依存関係をインストールします:
npm install
  1. Google OAuth クライアント認証情報を、プロジェクト ルートのcredentials.jsonという名前のファイルに配置します。
{ "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. Googleで認証する:
node index.js auth

これにより、ブラウザ ウィンドウが起動し、OAuth フローが完了し、資格情報がtokens.jsonに保存されます。

  1. claude_desktop_config.json (通常は%APPDATA%\Claude\内) を更新して、Claude がこのサーバーを使用するように設定します。
{ "mcpServers": { "class": { "command": "node", "args": [ "PATH_TO_YOUR_DIRECTORY\\index.js" ] } } }

使用法

利用可能なツール

サーバーは、Google Classroom とやり取りするためのいくつかのツールを提供します。

1. courses - Google Classroom のすべてのコースを一覧表示します

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

2. course-details - 特定のコースの詳細情報を取得する

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

パラメータ:

  • courseId : コースのID( coursesツールから取得できます)

3. assignments - 特定のコースの課題を取得する

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

パラメータ:

  • courseId : コースのID( coursesツールから取得できます)

クロードの例題

  1. Google Classroomのコースをすべて表示
  2. ID 123456789 の私の数学コースの詳細をご覧ください
  3. ID 987654321 の歴史コースのすべての課題を表示します

権限

サーバーは次の Google Classroom API 権限を要求します。

  • classroom.courses.readonly - コース情報にアクセスする
  • classroom.announcements.readonly - コースのアナウンスにアクセスする
  • classroom.coursework.me.readonly - 授業や課題にアクセスするには
  • classroom.rosters.readonly - クラス名簿にアクセスする

トラブルシューティング

権限エラーが発生した場合は、以下を試してください。

  1. 権限を更新するには、再度 auth コマンドを実行します。
    node index.js auth
  2. アプリがテストモードの場合、Google Cloud Console で Google アカウントがテストユーザーとして追加されていることを確認します。
  3. authenticateAndSaveCredentials関数の OAuth スコープをチェックして、ニーズに合致していることを確認します。

注記

  • このサーバーは、Claude AI または他の MCP 互換アシスタントで使用するように設計されています。
  • すべての API リクエストは認証された Google アカウントを使用して行われます
  • トークンの更新はサーバーによって自動的に処理されます
  • 機密性の高い認証情報はtokens.jsonファイルにローカルに保存されます
-
security - not tested
F
license - not found
-
quality - not tested

AI アシスタントが Google Classroom データにアクセスして操作できるようにする MCP サーバー。ユーザーは自然言語コマンドを使用してコース、コースの詳細、課題を表示できます。

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