mcp-google-multi 5.2.0-alpha.2 → 5.2.0-alpha.4

package/README.md

@@ -9,7 +9,7 @@ A **local** [MCP](https://modelcontextprotocol.io) server that gives Claude Code
 - 🔑 **Multi-account** — drive any number of your Google accounts from one server, each by a short alias.
 - 🔒 **Secure by default** — refresh tokens **encrypted at rest** (AES-256-GCM); **writes are deny-by-default**; no telemetry — it talks only to Google.
 - 📦 **npm-first** — install and run with `npx`; everything configured through env vars.
-- 🧰 **~175 tools** across 13 services → full list in **[COVERAGE.md](./COVERAGE.md)**.
+- 🧰 **Exhaustive coverage** — every OAuth-reachable Workspace API method is a named tool: **871 tools across 28 services** (182 hand-curated + 689 generated from Google's API Discovery), plus an escape hatch for anything else → full list in **[COVERAGE.md](./COVERAGE.md)**.
 
 > v5 is **local + user-OAuth only**. Service accounts and hosting (and the APIs they unlock) are on the [roadmap](https://github.com/bakissation/mcp-google-multi/milestones). **Upgrading from v4?** Jump to [Upgrading](#upgrading-from-v4).
 
@@ -126,7 +126,7 @@ Reads are never gated. **Every create/update/delete is off until you opt in**
 
 ## What's covered
 
-~175 tools across Gmail, Drive, Calendar, Sheets, Docs, Contacts, Search Console, Tasks, Meet, and (optional) Slides, Forms, Chat, Workspace Admin. **Full per-tool list → [COVERAGE.md](./COVERAGE.md).** Every tool takes an `account` argument matching one of your aliases.
+Every OAuth-reachable Workspace API method is a named tool — 871 across 28 services. Core services (Gmail, Drive, Calendar, Sheets, Docs, Contacts, Search Console, Tasks, Meet) are on by default; Slides, Forms, Chat, Classroom, Vault, Keep, Apps Script, Cloud Search, Drive Labels and more enable via `GOOGLE_OPTIONAL_SCOPES` bundles, and Workspace Admin APIs via `GOOGLE_ADMIN_ACCOUNTS`. Curated tools give shaped, token-lean responses for everyday operations; generated tools (from Google's API Discovery documents) cover the long tail with the same write-control and account fan-out. **Full per-tool list → [COVERAGE.md](./COVERAGE.md).** Every tool takes an `account` argument matching one of your aliases.
 
 ## Google Cloud setup
 

package/dist/auth.js

@@ -39,6 +39,39 @@ export const OPTIONAL_SCOPE_BUNDLES = {
         'https://www.googleapis.com/auth/chat.messages',
         'https://www.googleapis.com/auth/chat.messages.create',
     ],
+    classroom: [
+        'https://www.googleapis.com/auth/classroom.courses',
+        'https://www.googleapis.com/auth/classroom.coursework.me',
+        'https://www.googleapis.com/auth/classroom.coursework.students',
+        'https://www.googleapis.com/auth/classroom.courseworkmaterials',
+        'https://www.googleapis.com/auth/classroom.rosters',
+        'https://www.googleapis.com/auth/classroom.announcements',
+        'https://www.googleapis.com/auth/classroom.topics',
+    ],
+    cloudidentity: [
+        'https://www.googleapis.com/auth/cloud-identity.groups',
+        'https://www.googleapis.com/auth/cloud-identity.devices',
+    ],
+    cloudsearch: ['https://www.googleapis.com/auth/cloud_search'],
+    vault: ['https://www.googleapis.com/auth/ediscovery'],
+    keep: ['https://www.googleapis.com/auth/keep'],
+    driveactivity: ['https://www.googleapis.com/auth/drive.activity.readonly'],
+    drivelabels: [
+        'https://www.googleapis.com/auth/drive.labels',
+        'https://www.googleapis.com/auth/drive.admin.labels',
+    ],
+    script: [
+        'https://www.googleapis.com/auth/script.projects',
+        'https://www.googleapis.com/auth/script.deployments',
+        'https://www.googleapis.com/auth/script.processes',
+        'https://www.googleapis.com/auth/script.metrics',
+    ],
+    postmaster: ['https://www.googleapis.com/auth/postmaster.readonly'],
+    groupssettings: ['https://www.googleapis.com/auth/apps.groups.settings'],
+    groupsmigration: ['https://www.googleapis.com/auth/apps.groups.migration'],
+    licensing: ['https://www.googleapis.com/auth/apps.licensing'],
+    reseller: ['https://www.googleapis.com/auth/apps.order'],
+    appsmarket: ['https://www.googleapis.com/auth/appsmarketplace.license'],
 };
 export const ADMIN_SCOPES = [
     'https://www.googleapis.com/auth/admin.reports.audit.readonly',

package/dist/discovery-client.js

@@ -18,7 +18,20 @@ export const WORKSPACE_APIS = {
     drivelabels: { id: 'drivelabels', version: 'v2' },
     admin_directory: { id: 'admin', version: 'directory_v1' },
     admin_reports: { id: 'admin', version: 'reports_v1' },
+    admin_datatransfer: { id: 'admin', version: 'datatransfer_v1' },
     groupssettings: { id: 'groupssettings', version: 'v1' },
+    appsmarket: { id: 'appsmarket', version: 'v2' },
+    classroom: { id: 'classroom', version: 'v1' },
+    cloudidentity: { id: 'cloudidentity', version: 'v1' },
+    cloudsearch: { id: 'cloudsearch', version: 'v1' },
+    groupsmigration: { id: 'groupsmigration', version: 'v1' },
+    keep: { id: 'keep', version: 'v1' },
+    licensing: { id: 'licensing', version: 'v1' },
+    postmaster: { id: 'gmailpostmastertools', version: 'v1' },
+    reseller: { id: 'reseller', version: 'v1' },
+    script: { id: 'script', version: 'v1' },
+    vault: { id: 'vault', version: 'v1' },
+    workspaceevents: { id: 'workspaceevents', version: 'v1' },
 };
 const TTL_MS = 7 * 24 * 60 * 60 * 1000;
 const STALE_RETRY_MS = 5 * 60 * 1000;

package/dist/index.js

@@ -5,21 +5,8 @@ import { fileURLToPath } from 'node:url';
 import path from 'node:path';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { registerGmailTools } from './tools/gmail.js';
-import { registerDriveTools } from './tools/drive.js';
-import { registerCalendarTools } from './tools/calendar.js';
-import { registerSheetsTools } from './tools/sheets.js';
-import { registerDocsTools } from './tools/docs.js';
-import { registerContactsTools } from './tools/contacts.js';
-import { registerSearchConsoleTools } from './tools/searchconsole.js';
-import { registerTasksTools } from './tools/tasks.js';
-import { registerMeetTools } from './tools/meet.js';
-import { registerSlidesTools } from './tools/slides.js';
-import { registerFormsTools } from './tools/forms.js';
-import { registerChatTools } from './tools/chat.js';
-import { registerAdminTools } from './tools/admin.js';
-import { getOptionalBundles, getAdminAccounts } from './auth.js';
 import { GENERATED_SERVICES } from './tools/generated/index.js';
+import { GENERATED_GATES, SERVICES } from './services.js';
 import { ToolRegistry } from './registry.js';
 import { registerDiscoverTools } from './discover.js';
 import { registerEscapeTools } from './tools/google-api.js';
@@ -28,24 +15,6 @@ import { getToolsets, toolsetEnabled } from './toolsets.js';
 import { resolvePolicy, isAllowed, describePolicy } from './write-control.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(path.resolve(__dirname, '..', 'package.json'), 'utf-8'));
-const SERVICES = [
-    { name: 'gmail', register: registerGmailTools },
-    { name: 'drive', register: registerDriveTools },
-    { name: 'calendar', register: registerCalendarTools },
-    { name: 'sheets', register: registerSheetsTools },
-    { name: 'docs', register: registerDocsTools },
-    { name: 'contacts', register: registerContactsTools },
-    { name: 'searchconsole', register: registerSearchConsoleTools },
-    { name: 'tasks', register: registerTasksTools },
-    { name: 'meet', register: registerMeetTools },
-    { name: 'slides', register: registerSlidesTools, enabled: () => new Set(getOptionalBundles()).has('slides') },
-    { name: 'forms', register: registerFormsTools, enabled: () => new Set(getOptionalBundles()).has('forms') },
-    { name: 'chat', register: registerChatTools, enabled: () => new Set(getOptionalBundles()).has('chat') },
-    { name: 'admin', register: registerAdminTools, enabled: () => getAdminAccounts().length > 0 },
-];
-// Opt-in gates for generated-only services whose scopes are not granted by
-// default; shared services (admin, forms, chat) reuse their curated gate below.
-const GENERATED_GATES = {};
 function buildRegistry(server, policy) {
     const registry = new ToolRegistry(server, policy);
     const toolsets = getToolsets();
@@ -83,9 +52,10 @@ function buildRegistry(server, policy) {
         gen.register(registry);
     }
     if (registry.services().length === 0) {
+        const known = [...new Set([...SERVICES.map((s) => s.name), ...GENERATED_SERVICES.map((s) => s.name)])].sort();
         throw new Error(`GOOGLE_TOOLSETS="${process.env.GOOGLE_TOOLSETS ?? ''}" selected no enabled services. ` +
-            `Known services: ${SERVICES.map((s) => s.name).join(', ')}. ` +
-            `Note: slides/forms/chat require GOOGLE_OPTIONAL_SCOPES, admin requires GOOGLE_ADMIN_ACCOUNTS.`);
+            `Known services: ${known.join(', ')}. ` +
+            `Note: optional services require their bundle in GOOGLE_OPTIONAL_SCOPES, admin requires GOOGLE_ADMIN_ACCOUNTS.`);
     }
     registerDiscoverTools(registry, policy);
     registerEscapeTools(registry, policy);

package/dist/services.d.ts

@@ -0,0 +1,11 @@
+import type { ToolRegistry } from './registry.js';
+export interface ServiceEntry {
+    name: string;
+    register: (registry: ToolRegistry) => void;
+    enabled?: () => boolean;
+}
+export declare const SERVICES: ServiceEntry[];
+export declare const GENERATED_GATES: Record<string, {
+    enabled: () => boolean;
+    hint: string;
+}>;

package/dist/services.js

@@ -0,0 +1,53 @@
+import { registerGmailTools } from './tools/gmail.js';
+import { registerDriveTools } from './tools/drive.js';
+import { registerCalendarTools } from './tools/calendar.js';
+import { registerSheetsTools } from './tools/sheets.js';
+import { registerDocsTools } from './tools/docs.js';
+import { registerContactsTools } from './tools/contacts.js';
+import { registerSearchConsoleTools } from './tools/searchconsole.js';
+import { registerTasksTools } from './tools/tasks.js';
+import { registerMeetTools } from './tools/meet.js';
+import { registerSlidesTools } from './tools/slides.js';
+import { registerFormsTools } from './tools/forms.js';
+import { registerChatTools } from './tools/chat.js';
+import { registerAdminTools } from './tools/admin.js';
+import { getOptionalBundles, getAdminAccounts } from './auth.js';
+export const SERVICES = [
+    { name: 'gmail', register: registerGmailTools },
+    { name: 'drive', register: registerDriveTools },
+    { name: 'calendar', register: registerCalendarTools },
+    { name: 'sheets', register: registerSheetsTools },
+    { name: 'docs', register: registerDocsTools },
+    { name: 'contacts', register: registerContactsTools },
+    { name: 'searchconsole', register: registerSearchConsoleTools },
+    { name: 'tasks', register: registerTasksTools },
+    { name: 'meet', register: registerMeetTools },
+    { name: 'slides', register: registerSlidesTools, enabled: () => new Set(getOptionalBundles()).has('slides') },
+    { name: 'forms', register: registerFormsTools, enabled: () => new Set(getOptionalBundles()).has('forms') },
+    { name: 'chat', register: registerChatTools, enabled: () => new Set(getOptionalBundles()).has('chat') },
+    { name: 'admin', register: registerAdminTools, enabled: () => getAdminAccounts().length > 0 },
+];
+// Opt-in gates for generated-only services whose scopes are not granted by
+// default; shared services (admin, forms, chat) reuse their curated gate in
+// buildRegistry. workspaceevents has no dedicated scope (subscriptions use the
+// underlying resource scopes), so it registers ungated.
+const bundleGate = (name) => ({
+    enabled: () => new Set(getOptionalBundles()).has(name),
+    hint: `add "${name}" to GOOGLE_OPTIONAL_SCOPES`,
+});
+export const GENERATED_GATES = {
+    appsmarket: bundleGate('appsmarket'),
+    classroom: bundleGate('classroom'),
+    cloudidentity: bundleGate('cloudidentity'),
+    cloudsearch: bundleGate('cloudsearch'),
+    driveactivity: bundleGate('driveactivity'),
+    drivelabels: bundleGate('drivelabels'),
+    groupsmigration: bundleGate('groupsmigration'),
+    groupssettings: bundleGate('groupssettings'),
+    keep: bundleGate('keep'),
+    licensing: bundleGate('licensing'),
+    postmaster: bundleGate('postmaster'),
+    reseller: bundleGate('reseller'),
+    script: bundleGate('script'),
+    vault: bundleGate('vault'),
+};

package/dist/tools/generated/admin.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from '../../registry.js';
+export declare function registerAdminGeneratedTools(registry: ToolRegistry): void;