Classroom Suite

A unified MCP (Model Context Protocol) server for Google Workspace education tools - seamlessly integrate Google Classroom, Google Drive, and Google Docs with AI assistants like Claude.

PyPI version License: MIT Python 3.10+

✨ Features

Service	Tools	Description
📚 Classroom	6	Manage courses, assignments, and submissions
📁 Drive	7	Create, upload, download, and share files
📝 Docs	4	Create, read, edit documents and export to PDF

17 tools total - Everything you need for education automation!

🚀 Installation

Using uvx (Recommended)

uvx classroom-suite-mcp

Using pip

pip install classroom-suite-mcp

From Source

git clone https://github.com/anasdevai/classroom-suite-mcp.git
cd classroom-suite-mcp
pip install -e .

🔐 Google Cloud Setup

Before using this server, you need to set up Google Cloud credentials:

1. Create a Google Cloud Project

1. Go to Google Cloud Console
2. Create a new project or select an existing one
3. Enable the following APIs:
   • Google Classroom API
   • Google Drive API
   • Google Docs API

2. Create OAuth Credentials

1. Go to APIs & Services > Credentials
2. Click Create Credentials > OAuth client ID
3. Select Desktop app as the application type
4. Download the credentials as credentials.json

3. Configure the Server

Place credentials.json in your working directory, or set the path:

export GOOGLE_CREDENTIALS_PATH=/path/to/credentials.json

On first run, a browser window will open for OAuth authentication.

⚙️ Configuration

Environment Variables

Variable	Default	Description
GOOGLE_CREDENTIALS_PATH	credentials.json	Path to OAuth credentials file
GOOGLE_TOKEN_PATH	token.json	Path to store auth token

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "classroom-suite": {
      "command": "uvx",
      "args": ["classroom-suite-mcp"]
    }
  }
}

Or with pip installation:

{
  "mcpServers": {
    "classroom-suite": {
      "command": "classroom-suite-mcp"
    }
  }
}

🛠️ Available Tools

Google Classroom (6 tools)

Tool	Description
list_courses	List all enrolled courses
get_course	Get course details
list_assignments	List course assignments
get_assignment	Get assignment details
list_submissions	List assignment submissions
submit_assignment	Submit work with attachments

Google Drive (7 tools)

Tool	Description
list_files	List files and folders
search_files	Search by name or content
create_folder	Create a new folder
upload_file	Upload a file
download_file	Download a file
share_file	Share with users or publicly
delete_file	Move to trash or delete

Google Docs (4 tools)

Tool	Description
create_doc	Create a new document
read_doc	Read document content
update_doc	Append, prepend, or replace text
export_pdf	Export as PDF

📖 Usage Examples

With Claude

You: List my Google Classroom courses

Claude: I'll list your courses using the classroom-suite-mcp tools.
[Uses list_courses tool]

Here are your courses:
1. Introduction to Computer Science (ACTIVE)
2. Data Structures and Algorithms (ACTIVE)
...

Common Workflows

Check assignments and submit:

1. list_courses → Get course ID
2. list_assignments → Find pending assignment
3. create_doc → Create solution document
4. submit_assignment → Submit with Drive file

Organize course materials:

1. create_folder → Create organized folder
2. upload_file → Upload materials
3. share_file → Share with classmates

🧪 Development

Running Locally

# Clone the repository
git clone https://github.com/anasdevai/classroom-suite-mcp.git
cd classroom-suite-mcp

# Install dependencies
pip install -e .

# Run with stdio transport (for MCP clients)
classroom-suite-mcp

# Run with HTTP transport (for testing)
classroom-suite-mcp --transport http --port 8000

Testing with MCP Inspector

npx @anthropic-ai/mcp-inspector classroom-suite-mcp

📄 License

MIT License - see LICENSE for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📬 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

Made with ❤️ for educators and students