🎓 Classroom Suite MCP

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.

✨ Features

17 tools total - Everything you need for education automation!

Related MCP server: mcp-google-gdrive

🚀 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

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)

Google Drive (7 tools)

Google Docs (4 tools)

📖 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