mcp-gsuite
Author: MarkusPfundstein
Description: MCP (Model-Context-Protocol) server that exposes Gmail and Google Calendar tooling – query mail, draft/reply messages, manage events, and handle multiple Google accounts via OAuth2.
Stars: 413
Forks: 83
License: MIT License
Category: Open Source
Overview
Installation
1. Prerequisites
• Python >= 3.8
• A Google Cloud project with Workspace (G-Suite) APIs you intend to use enabled (e.g. Admin SDK, Gmail, Drive).
• A service-account JSON key or OAuth2 client-secret file with the required scopes.
2. Clone the repository
git clone https://github.com/MarkusPfundstein/mcp-gsuite.git
cd mcp-gsuite3. Install Python dependencies
# If a requirements.txt file exists
pip install -r requirements.txt
# Otherwise install Google client libraries manually
pip install google-auth google-auth-oauthlib google-api-python-client4. Provide Google credentials
• Service account: export GOOGLE_APPLICATION_CREDENTIALS=/full/path/key.json
• OAuth2: place client_secret.json in the project root (the server prompts for consent on first run).
5. Start the MCP server
python -m mcp_gsuite.server --port 80806. Verify
Curl the health endpoint: curl http://localhost:8080/healthLicense: MIT License
Updated 7/30/2025