@gemstack/connector-google-drive 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Suleiman Shahbari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# @gemstack/connector-google-drive
+
+A Google Drive connector for GemStack AI orchestration. Browse, read, and share Drive files over the Drive REST API (v3). Built with [`@gemstack/connectors`](../connectors); the result is a standard `@gemstack/mcp` server.
+
+## Install
+
+```bash
+npm i @gemstack/connector-google-drive @gemstack/connectors @gemstack/mcp
+```
+
+## Use
+
+```ts
+import { mountConnectors } from '@gemstack/connectors'
+import { Mcp } from '@gemstack/mcp'
+import drive from '@gemstack/connector-google-drive'
+
+const Server = mountConnectors([drive], {
+  // A Google OAuth 2.0 access token with a Drive scope.
+  credentials: () => ({ token: process.env.GOOGLE_ACCESS_TOKEN }),
+})
+
+Mcp.web('/mcp/drive', Server)
+```
+
+Tools are exposed namespaced by connector id, e.g. `google-drive_list-files`.
+
+## Auth
+
+Drive has no static API key — it is OAuth 2.0 only. The connector declares `auth: { type: 'oauth', scopes: ['https://www.googleapis.com/auth/drive'] }` and consumes a bearer token from `ctx.auth.token`; it does no OAuth handshake itself. Use `drive.readonly` if you only need the read tools. To protect a web endpoint and obtain the token, wrap it with `@gemstack/mcp`'s `oauth2McpMiddleware` + `registerOAuth2Metadata` and feed the verified token through the mount `credentials` option.
+
+## Tools
+
+| Tool | Kind | Description |
+|---|---|---|
+| `get-about` | read | Authenticated user + storage usage |
+| `list-files` | read | List files (folder / raw query scoped) |
+| `search-files` | read | Search by name and full-text content |
+| `get-file` | read | Metadata for one file or folder |
+| `get-file-content` | read | File as text (Docs exported, others downloaded) |
+| `list-permissions` | read | Who has access to a file |
+| `create-folder` | write | Create a folder |
+| `share-file` | write | Grant access (create a permission) |
+| `trash-file` | write (destructive) | Move a file to the trash (reversible) |
+
+Read tools are annotated `readOnly` so an agent can auto-approve them; write tools are not, and `trash-file` is marked `destructive`.
+
+Responses are slimmed to the fields an agent needs (no raw API envelopes) to keep token usage down.

package/dist/client.d.ts

@@ -0,0 +1,15 @@
+import type { ConnectorContext } from '@gemstack/connectors';
+/** Thrown when the Google Drive API returns a non-2xx response. */
+export declare class GoogleDriveError extends Error {
+    status: number;
+    constructor(status: number, message: string);
+}
+/**
+ * Minimal Google Drive REST (v3) client over global `fetch`. The bearer comes
+ * from the connector context (`ctx.auth.token`) — a Google OAuth 2.0 access
+ * token. No SDK dependency, so the connector stays light.
+ */
+export declare function gd<T = unknown>(ctx: ConnectorContext, method: string, path: string, body?: unknown): Promise<T>;
+/** GET a file's raw bytes as text (for `alt=media` downloads and Docs exports). */
+export declare function gdText(ctx: ConnectorContext, path: string): Promise<string>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAI5D,mEAAmE;AACnE,qBAAa,gBAAiB,SAAQ,KAAK;IAEhC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAaD;;;;GAIG;AACH,wBAAsB,EAAE,CAAC,CAAC,GAAG,OAAO,EAClC,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED,mFAAmF;AACnF,wBAAsB,MAAM,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQjF"}

package/dist/client.js

@@ -0,0 +1,52 @@
+const API = 'https://www.googleapis.com/drive/v3';
+/** Thrown when the Google Drive API returns a non-2xx response. */
+export class GoogleDriveError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'GoogleDriveError';
+    }
+}
+function bearer(ctx) {
+    const token = ctx.auth.token;
+    if (!token) {
+        throw new GoogleDriveError(401, 'no Google access token available — provide an OAuth bearer via the mount `credentials` option');
+    }
+    return token;
+}
+/**
+ * Minimal Google Drive REST (v3) client over global `fetch`. The bearer comes
+ * from the connector context (`ctx.auth.token`) — a Google OAuth 2.0 access
+ * token. No SDK dependency, so the connector stays light.
+ */
+export async function gd(ctx, method, path, body) {
+    const token = bearer(ctx);
+    const res = await fetch(`${API}${path}`, {
+        method,
+        headers: {
+            Authorization: `Bearer ${token}`,
+            Accept: 'application/json',
+            ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),
+        },
+        ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+    });
+    if (!res.ok) {
+        const detail = await res.text().catch(() => '');
+        throw new GoogleDriveError(res.status, `${method} ${path} -> ${res.status} ${res.statusText}${detail ? `: ${detail}` : ''}`);
+    }
+    if (res.status === 204)
+        return undefined;
+    return (await res.json());
+}
+/** GET a file's raw bytes as text (for `alt=media` downloads and Docs exports). */
+export async function gdText(ctx, path) {
+    const token = bearer(ctx);
+    const res = await fetch(`${API}${path}`, { method: 'GET', headers: { Authorization: `Bearer ${token}` } });
+    if (!res.ok) {
+        const detail = await res.text().catch(() => '');
+        throw new GoogleDriveError(res.status, `GET ${path} -> ${res.status} ${res.statusText}${detail ? `: ${detail}` : ''}`);
+    }
+    return await res.text();
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { GoogleDriveError } from './client.js';
+/**
+ * Google Drive connector: browse, read, and share Drive files.
+ *
+ * Auth is a Google OAuth 2.0 access token. Drive has no static API key, so the
+ * orchestrator supplies a bearer via the mount `credentials` option (the same
+ * seam every connector uses).
+ */
+declare const _default: import("@gemstack/connectors").Connector;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAuC9C;;;;;;GAMG;;AACH,wBAgME"}

package/dist/index.js

@@ -0,0 +1,217 @@
+import { defineConnector } from '@gemstack/connectors';
+import { z } from 'zod';
+import { gd, gdText } from './client.js';
+export { GoogleDriveError } from './client.js';
+const enc = encodeURIComponent;
+const FOLDER_MIME = 'application/vnd.google-apps.folder';
+/** Fields requested for a file listing/metadata, kept to what an agent needs. */
+const FILE_FIELDS = 'id,name,mimeType,size,modifiedTime,owners(emailAddress),webViewLink';
+/** Escape a string for use inside a single-quoted Drive query literal. */
+const driveStr = (s) => s.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+/** Slim a Drive file resource down to the fields an agent needs. */
+function slimFile(f) {
+    return {
+        id: f.id,
+        name: f.name,
+        mimeType: f.mimeType,
+        isFolder: f.mimeType === FOLDER_MIME,
+        size: f.size != null ? Number(f.size) : undefined,
+        modifiedTime: f.modifiedTime,
+        owners: Array.isArray(f.owners) ? f.owners.map((o) => o?.emailAddress).filter(Boolean) : undefined,
+        url: f.webViewLink,
+    };
+}
+/** Map a Google editor mime type to the text format it can be exported as. */
+function exportMimeFor(mime) {
+    switch (mime) {
+        case 'application/vnd.google-apps.document':
+            return 'text/plain';
+        case 'application/vnd.google-apps.spreadsheet':
+            return 'text/csv';
+        case 'application/vnd.google-apps.presentation':
+            return 'text/plain';
+        default:
+            return undefined;
+    }
+}
+/**
+ * Google Drive connector: browse, read, and share Drive files.
+ *
+ * Auth is a Google OAuth 2.0 access token. Drive has no static API key, so the
+ * orchestrator supplies a bearer via the mount `credentials` option (the same
+ * seam every connector uses).
+ */
+export default defineConnector({
+    id: 'google-drive',
+    name: 'Google Drive',
+    instructions: 'Browse, read, and share files in Google Drive.',
+    auth: {
+        type: 'oauth',
+        scopes: ['https://www.googleapis.com/auth/drive'],
+        description: 'Google OAuth 2.0 access token with a Drive scope (`drive` for full access, `drive.readonly` for read-only).',
+    },
+    tools: [
+        {
+            name: 'get-about',
+            description: "Get the authenticated user's identity and Drive storage usage.",
+            schema: z.object({}),
+            annotations: { readOnly: true, openWorld: true },
+            handle: async (_input, ctx) => {
+                const a = await gd(ctx, 'GET', '/about?fields=user(displayName,emailAddress),storageQuota(limit,usage)');
+                return {
+                    user: a.user?.displayName,
+                    email: a.user?.emailAddress,
+                    storageUsage: a.storageQuota?.usage != null ? Number(a.storageQuota.usage) : undefined,
+                    storageLimit: a.storageQuota?.limit != null ? Number(a.storageQuota.limit) : undefined,
+                };
+            },
+        },
+        {
+            name: 'list-files',
+            description: 'List files (newest first). Optionally scope to a folder, or pass a raw Drive `query` expression. Trashed files are excluded by default.',
+            schema: z.object({
+                folderId: z.string().min(1).optional(),
+                query: z.string().min(1).optional(),
+                includeTrashed: z.boolean().optional(),
+                limit: z.number().int().min(1).max(100).optional(),
+            }),
+            annotations: { readOnly: true, openWorld: true },
+            handle: async (input, ctx) => {
+                const clauses = [];
+                if (input.folderId)
+                    clauses.push(`'${driveStr(input.folderId)}' in parents`);
+                if (!input.includeTrashed)
+                    clauses.push('trashed = false');
+                if (input.query)
+                    clauses.push(`(${input.query})`);
+                const params = new URLSearchParams({
+                    pageSize: String(input.limit ?? 30),
+                    orderBy: 'modifiedTime desc',
+                    fields: `files(${FILE_FIELDS})`,
+                });
+                if (clauses.length)
+                    params.set('q', clauses.join(' and '));
+                const res = await gd(ctx, 'GET', `/files?${params}`);
+                return (res.files ?? []).map(slimFile);
+            },
+        },
+        {
+            name: 'search-files',
+            description: 'Search Drive by file name and full-text content. Trashed files are excluded.',
+            schema: z.object({ text: z.string().min(1), limit: z.number().int().min(1).max(100).optional() }),
+            annotations: { readOnly: true, openWorld: true },
+            handle: async (input, ctx) => {
+                const t = driveStr(input.text);
+                const params = new URLSearchParams({
+                    q: `(name contains '${t}' or fullText contains '${t}') and trashed = false`,
+                    pageSize: String(input.limit ?? 20),
+                    orderBy: 'modifiedTime desc',
+                    fields: `files(${FILE_FIELDS})`,
+                });
+                const res = await gd(ctx, 'GET', `/files?${params}`);
+                return (res.files ?? []).map(slimFile);
+            },
+        },
+        {
+            name: 'get-file',
+            description: 'Get metadata for a single file or folder by id.',
+            schema: z.object({ fileId: z.string().min(1) }),
+            annotations: { readOnly: true, openWorld: true },
+            handle: async (input, ctx) => {
+                const f = await gd(ctx, 'GET', `/files/${enc(input.fileId)}?fields=${FILE_FIELDS},parents,description`);
+                return { ...slimFile(f), parents: f.parents, description: f.description };
+            },
+        },
+        {
+            name: 'get-file-content',
+            description: 'Read a file as text. Google Docs/Sheets/Slides are exported (to text/CSV); other files are downloaded directly.',
+            schema: z.object({ fileId: z.string().min(1) }),
+            annotations: { readOnly: true, openWorld: true },
+            handle: async (input, ctx) => {
+                const id = enc(input.fileId);
+                const meta = await gd(ctx, 'GET', `/files/${id}?fields=id,name,mimeType`);
+                const mime = meta.mimeType ?? '';
+                if (mime === FOLDER_MIME)
+                    return { error: `"${meta.name}" is a folder, not a file` };
+                let content;
+                if (mime.startsWith('application/vnd.google-apps.')) {
+                    const exportMime = exportMimeFor(mime);
+                    if (!exportMime)
+                        return { error: `cannot export ${mime} as text` };
+                    content = await gdText(ctx, `/files/${id}/export?mimeType=${enc(exportMime)}`);
+                }
+                else {
+                    content = await gdText(ctx, `/files/${id}?alt=media`);
+                }
+                return { id: meta.id, name: meta.name, mimeType: mime, content };
+            },
+        },
+        {
+            name: 'list-permissions',
+            description: 'List who has access to a file or folder.',
+            schema: z.object({ fileId: z.string().min(1) }),
+            annotations: { readOnly: true, openWorld: true },
+            handle: async (input, ctx) => {
+                const res = await gd(ctx, 'GET', `/files/${enc(input.fileId)}/permissions?fields=permissions(id,type,role,emailAddress,domain)`);
+                return (res.permissions ?? []).map((p) => ({
+                    id: p.id,
+                    type: p.type,
+                    role: p.role,
+                    emailAddress: p.emailAddress,
+                    domain: p.domain,
+                }));
+            },
+        },
+        {
+            name: 'create-folder',
+            description: 'Create a new folder, optionally inside a parent folder.',
+            schema: z.object({ name: z.string().min(1), parentId: z.string().min(1).optional() }),
+            annotations: { openWorld: true },
+            handle: async (input, ctx) => {
+                const payload = { name: input.name, mimeType: FOLDER_MIME };
+                if (input.parentId)
+                    payload.parents = [input.parentId];
+                const f = await gd(ctx, 'POST', `/files?fields=id,name,webViewLink`, payload);
+                return { id: f.id, name: f.name, url: f.webViewLink };
+            },
+        },
+        {
+            name: 'share-file',
+            description: 'Grant access to a file or folder by creating a permission.',
+            schema: z.object({
+                fileId: z.string().min(1),
+                role: z.enum(['reader', 'commenter', 'writer', 'owner']).optional(),
+                type: z.enum(['user', 'group', 'domain', 'anyone']).optional(),
+                emailAddress: z.string().min(1).optional(),
+                domain: z.string().min(1).optional(),
+            }),
+            annotations: { openWorld: true },
+            handle: async (input, ctx) => {
+                const type = input.type ?? 'user';
+                if ((type === 'user' || type === 'group') && !input.emailAddress) {
+                    return { error: `type "${type}" requires an emailAddress` };
+                }
+                if (type === 'domain' && !input.domain)
+                    return { error: 'type "domain" requires a domain' };
+                const payload = { role: input.role ?? 'reader', type };
+                if (input.emailAddress)
+                    payload.emailAddress = input.emailAddress;
+                if (input.domain)
+                    payload.domain = input.domain;
+                const p = await gd(ctx, 'POST', `/files/${enc(input.fileId)}/permissions?fields=id,role,type`, payload);
+                return { id: p.id, role: p.role, type: p.type };
+            },
+        },
+        {
+            name: 'trash-file',
+            description: 'Move a file or folder to the trash (reversible).',
+            schema: z.object({ fileId: z.string().min(1) }),
+            annotations: { destructive: true, openWorld: true },
+            handle: async (input, ctx) => {
+                const f = await gd(ctx, 'PATCH', `/files/${enc(input.fileId)}?fields=id,name,trashed`, { trashed: true });
+                return { id: f.id, name: f.name, trashed: f.trashed };
+            },
+        },
+    ],
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@gemstack/connector-google-drive",
+  "version": "0.1.0",
+  "description": "Google Drive connector for GemStack AI orchestration: browse, read, and share Drive files over the Drive REST API. Built with @gemstack/connectors.",
+  "keywords": [
+    "mcp",
+    "connector",
+    "google-drive",
+    "ai",
+    "agents",
+    "orchestration",
+    "gemstack"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/gemstack-land/gemstack/tree/main/packages/connector-google-drive#readme",
+  "bugs": {
+    "url": "https://github.com/gemstack-land/gemstack/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gemstack-land/gemstack",
+    "directory": "packages/connector-google-drive"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "zod": "^4.0.0",
+    "@gemstack/connectors": "^0.1.0",
+    "@gemstack/mcp": "^0.2.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "reflect-metadata": "^0.2.0",
+    "typescript": "^5.4.0"
+  },
+  "author": "Suleiman Shahbari",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "tsc -p tsconfig.test.json && cd dist-test && node --test",
+    "clean": "rm -rf dist dist-test"
+  }
+}