🎓 ClassroomScribe: Google Classroom MCP Server

Google Classroom integration for LLMs and AI agents (MCP). Pulls course lists, active coursework, announcements, and organizes upcoming assignments into prioritized TODO summaries.

🛠️ MCP Tools Exposed

1. list_courses: Lists all active classes you are enrolled in (returns Course names and IDs).

2. list_assignments: Shows upcoming and past assignments across all classes or for a specific course ID.

3. get_announcements: Fetches the latest stream posts and announcements for a specific class.

4. summarize_todo: Gathers all pending assignments, calculates the time left, and structures them into a prioritized list.

🚀 Setup & Launch

1. Enable the Classroom API: Ensure Google Classroom API is enabled on your credentials project in the Google Cloud Console.

2. Authenticate Scopes: Run the local OAuth flow script:

   ./auth.py

   Follow the browser prompts to authenticate the Classroom read-only scopes. This creates your local token.json.

3. Run the MCP Server:

   python3 classroom_server.py

📂 File Layout

• auth.py: Initial OAuth 2.0 flow handler.

• classroom_server.py: FastMCP server exposing Google Classroom tools.

• credentials.json: OAuth Client ID secrets (git-ignored).

• token.json: Generated authorization tokens (git-ignored).