Servidor MCP de Google Classroom

Un servidor MCP (Protocolo de contexto de modelo) que proporciona acceso a los datos de Google Classroom a través de Claude y otros asistentes de IA que admiten el protocolo MCP.

Configuración

Prerrequisitos

Node.js (v16 o superior)
Un proyecto de Google Cloud Platform con la API de Google Classroom habilitada
Credenciales de cliente OAuth 2.0 para la API de Google Classroom

Instalación

Instalación mediante herrería

Para instalar Google Classroom MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

Clonar este repositorio
Instalar dependencias:

npm install

Coloque sus credenciales de cliente de Google OAuth en un archivo llamado credentials.json en la raíz del proyecto:

{
  "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"]
  }
}

Autenticarse con Google:

node index.js auth

Esto abrirá una ventana del navegador para completar el flujo OAuth y guardar sus credenciales en tokens.json .

Configure Claude para usar este servidor actualizando claude_desktop_config.json (normalmente en %APPDATA%\Claude\ ):

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

Uso

Herramientas disponibles

El servidor proporciona varias herramientas para interactuar con Google Classroom:

1. `courses` : enumera todos tus cursos de Google Classroom

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

2. `course-details` : obtenga información detallada sobre un curso específico

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

Parámetros:

courseId : El ID del curso (se puede obtener desde la herramienta courses )

3. `assignments` : obtenga tareas para un curso específico

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

Parámetros:

courseId : El ID del curso (se puede obtener desde la herramienta courses )

Ejemplos de indicaciones para Claude

Muéstrame todos mis cursos de Google Classroom
Obtenga detalles de mi curso de Matemáticas con ID 123456789
Muéstrame todas las tareas de mi curso de Historia con ID 987654321

Permisos

El servidor solicita los siguientes permisos de la API de Google Classroom:

classroom.courses.readonly - Para acceder a la información del curso
classroom.announcements.readonly - Para acceder a los anuncios del curso
classroom.coursework.me.readonly - Para acceder a sus trabajos y tareas del curso
classroom.rosters.readonly - Para acceder a las listas de clases

Solución de problemas

Si encuentra errores de permisos, intente:

Ejecute nuevamente el comando auth para actualizar los permisos:
node index.js auth
Cómo asegurarse de que su cuenta de Google se agregue como usuario de prueba en Google Cloud Console si su aplicación está en modo de prueba
Comprobación de los alcances de OAuth en la función authenticateAndSaveCredentials para garantizar que coincidan con sus necesidades

Notas

Este servidor está diseñado para usarse con Claude AI u otros asistentes compatibles con MCP
Todas las solicitudes de API se realizan utilizando su cuenta de Google autenticada
La actualización del token la gestiona automáticamente el servidor
Las credenciales confidenciales se almacenan localmente en el archivo tokens.json

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

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

Un servidor MCP que permite a los asistentes de IA acceder e interactuar con los datos de Google Classroom, lo que permite a los usuarios ver cursos, detalles de los cursos y tareas a través de comandos de lenguaje natural.

Related MCP Servers

SEO AI Assistant
ayushsinghvi92
-
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 -
Google API Discovery Service MCP Server
ag2-mcp-servers
-
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
Cloud Vision API MCP Server
ag2-mcp-servers
-
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
Policy Analyzer API MCP Server
ag2-mcp-servers
-
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

View all related MCP servers

Google Classroom MCP Server