Add Google Groups support

Author: darkdreamingdan

README.md

@@ -1045,6 +1045,21 @@ Saved files expire after 1 hour and are cleaned up automatically.
 | `manage_contacts_batch` | Complete | Batch create, update, or delete contacts |
 | `manage_contact_group` | Complete | Create, update, delete groups, or modify membership |
 
+</td>
+<td width="50%" valign="top">
+
+### 👥 **Google Groups** <sub>[`groups_tools.py`](ggroups/groups_tools.py)</sub>
+
+| Tool | Tier | Description |
+|------|------|-------------|
+| `search_groups` | **Core** | Search groups with CEL queries |
+| `get_group` | **Core** | Retrieve group details |
+| `list_group_members` | **Core** | List members of a group |
+| `manage_group` | **Core** | Create, update, or delete groups |
+| `manage_group_members` | Extended | Add, remove, or modify member roles |
+| `list_groups` | Complete | List all groups under a customer |
+| `lookup_group` | Complete | Look up group resource name by email |
+
 </td>
 </tr>
 <tr>

auth/permissions.py

@@ -46,6 +46,8 @@
     TASKS_READONLY_SCOPE,
     CONTACTS_SCOPE,
     CONTACTS_READONLY_SCOPE,
+    GROUPS_SCOPE,
+    GROUPS_READONLY_SCOPE,
     CUSTOM_SEARCH_SCOPE,
     SCRIPT_PROJECTS_SCOPE,
     SCRIPT_PROJECTS_READONLY_SCOPE,
@@ -105,6 +107,10 @@
         ("readonly", [CONTACTS_READONLY_SCOPE]),
         ("full", [CONTACTS_SCOPE]),
     ],
+    "groups": [
+        ("readonly", [GROUPS_READONLY_SCOPE]),
+        ("full", [GROUPS_SCOPE]),
+    ],
     "search": [
         ("readonly", [CUSTOM_SEARCH_SCOPE]),
         ("full", [CUSTOM_SEARCH_SCOPE]),

auth/scopes.py

@@ -66,6 +66,12 @@
 CONTACTS_SCOPE = "https://www.googleapis.com/auth/contacts"
 CONTACTS_READONLY_SCOPE = "https://www.googleapis.com/auth/contacts.readonly"
 
+# Google Groups (Cloud Identity) scopes
+GROUPS_SCOPE = "https://www.googleapis.com/auth/cloud-identity.groups"
+GROUPS_READONLY_SCOPE = (
+    "https://www.googleapis.com/auth/cloud-identity.groups.readonly"
+)
+
 # Google Custom Search API scope
 CUSTOM_SEARCH_SCOPE = "https://www.googleapis.com/auth/cse"
 
@@ -98,6 +104,7 @@
     SLIDES_SCOPE: {SLIDES_READONLY_SCOPE},
     TASKS_SCOPE: {TASKS_READONLY_SCOPE},
     CONTACTS_SCOPE: {CONTACTS_READONLY_SCOPE},
+    GROUPS_SCOPE: {GROUPS_READONLY_SCOPE},
     CHAT_WRITE_SCOPE: {CHAT_READONLY_SCOPE},
     CHAT_SPACES_SCOPE: {CHAT_SPACES_READONLY_SCOPE},
     FORMS_BODY_SCOPE: {FORMS_BODY_READONLY_SCOPE},
@@ -173,6 +180,8 @@ def has_required_scopes(available_scopes, required_scopes):
 
 CONTACTS_SCOPES = [CONTACTS_SCOPE, CONTACTS_READONLY_SCOPE]
 
+GROUPS_SCOPES = [GROUPS_SCOPE, GROUPS_READONLY_SCOPE]
+
 CUSTOM_SEARCH_SCOPES = [CUSTOM_SEARCH_SCOPE]
 
 SCRIPT_SCOPES = [
@@ -197,6 +206,7 @@ def has_required_scopes(available_scopes, required_scopes):
     "slides": SLIDES_SCOPES,
     "tasks": TASKS_SCOPES,
     "contacts": CONTACTS_SCOPES,
+    "groups": GROUPS_SCOPES,
     "search": CUSTOM_SEARCH_SCOPES,
     "appscript": SCRIPT_SCOPES,
 }
@@ -213,6 +223,7 @@ def has_required_scopes(available_scopes, required_scopes):
     "slides": [SLIDES_READONLY_SCOPE],
     "tasks": [TASKS_READONLY_SCOPE],
     "contacts": [CONTACTS_READONLY_SCOPE],
+    "groups": [GROUPS_READONLY_SCOPE],
     "search": CUSTOM_SEARCH_SCOPES,
     "appscript": [
         SCRIPT_PROJECTS_READONLY_SCOPE,

auth/service_decorator.py

@@ -50,6 +50,8 @@
     TASKS_READONLY_SCOPE,
     CONTACTS_SCOPE,
     CONTACTS_READONLY_SCOPE,
+    GROUPS_SCOPE,
+    GROUPS_READONLY_SCOPE,
     CUSTOM_SEARCH_SCOPE,
     SCRIPT_PROJECTS_SCOPE,
     SCRIPT_PROJECTS_READONLY_SCOPE,
@@ -414,6 +416,7 @@ def _remove_user_email_arg_from_docstring(docstring: str) -> str:
     "people": {"service": "people", "version": "v1"},
     "customsearch": {"service": "customsearch", "version": "v1"},
     "script": {"service": "script", "version": "v1"},
+    "cloudidentity": {"service": "cloudidentity", "version": "v1"},
 }
 
 
@@ -457,6 +460,9 @@ def _remove_user_email_arg_from_docstring(docstring: str) -> str:
     # Contacts scopes
     "contacts": CONTACTS_SCOPE,
     "contacts_read": CONTACTS_READONLY_SCOPE,
+    # Groups (Cloud Identity) scopes
+    "groups": GROUPS_SCOPE,
+    "groups_read": GROUPS_READONLY_SCOPE,
     # Custom Search scope
     "customsearch": CUSTOM_SEARCH_SCOPE,
     # Apps Script scopes

core/tool_tiers.yaml

@@ -144,6 +144,18 @@ contacts:
     - manage_contacts_batch
     - manage_contact_group
 
+groups:
+  core:
+    - search_groups
+    - get_group
+    - list_group_members
+    - manage_group
+  extended:
+    - manage_group_members
+  complete:
+    - list_groups
+    - lookup_group
+
 search:
   core:
     - search_custom

fastmcp_server.py

@@ -148,6 +148,7 @@ def format(self, record):
 import gforms.forms_tools
 import gslides.slides_tools
 import gtasks.tasks_tools
+import ggroups.groups_tools
 import gsearch.search_tools
 
 # Configure tool registration
@@ -164,6 +165,7 @@ def format(self, record):
     "forms",
     "slides",
     "tasks",
+    "groups",
     "search",
 ]
 set_enabled_tools(all_services)  # Set enabled services for scopes

ggroups/__init__.py

@@ -0,0 +1,6 @@
+"""
+Google Groups MCP Integration (Cloud Identity API)
+
+This module provides MCP tools for interacting with Google Groups
+via the Cloud Identity Groups API.
+"""