ClassroomScribe

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).