@alanse/mcp-server-google-workspace 0.2.0 → 0.2.1

package/LICENSE

@@ -1,21 +1,95 @@
-MIT License
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
 
 Copyright (c) 2026 Alanse inc.
 
-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.
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor's trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/README.md

@@ -5,16 +5,9 @@
 🚀 **Current Status**: 59 tools (Drive: 2, Sheets: 57)
 📅 **Roadmap**: Google Docs, Calendar, Forms, Gmail, Slides
 
-This is an extended version of [@isaacphi/mcp-gdrive](https://github.com/isaacphi/mcp-gdrive), adding **53 additional Google Sheets API tools** for complete spreadsheet management and preparing for comprehensive Google Workspace coverage.
+Extended implementation by Alanse inc.
 
-## Credits
-
-This project is based on:
-- Original code by **Anthropic, PBC** from [MCP Servers](https://github.com/modelcontextprotocol/servers/tree/main/src/gdrive) (MIT License)
-- Enhanced by **Phil Isaac** in [@isaacphi/mcp-gdrive](https://github.com/isaacphi/mcp-gdrive) (MIT License)
-- **Extended implementation** by **Alanse株式会社 / Daichi Okazaki** (2026)
-
-All contributions are licensed under the MIT License.
+---
 
 ## 🚀 Features
 
@@ -65,7 +58,7 @@ For complete tool documentation, see [docs/api-comparison.md](./docs/api-compari
 
 The server provides access to Google Drive files:
 
-- **Files** (`gdrive:///<file_id>`)
+- **Files** (`gworkspace:///<file_id>`)
   - Supports all file types
   - Google Workspace files are automatically exported:
     - Docs → Markdown
@@ -83,12 +76,12 @@ The server provides access to Google Drive files:
 5. In order to allow interaction with sheets and docs you will also need to enable the [Google Sheets API](https://console.cloud.google.com/apis/api/sheets.googleapis.com/) and [Google Docs API](https://console.cloud.google.com/marketplace/product/google/docs.googleapis.com) in your workspaces Enabled API and Services section.
 6. [Create an OAuth Client ID](https://console.cloud.google.com/apis/credentials/oauthclient) for application type "Desktop App"
 7. Download the JSON file of your client's OAuth keys
-8. Rename the key file to `gcp-oauth.keys.json` and place into the path you specify with `GDRIVE_CREDS_DIR` (i.e. `/Users/username/.config/mcp-gdrive`)
+8. Rename the key file to `gcp-oauth.keys.json` and place into the path you specify with `GWORKSPACE_CREDS_DIR` (i.e. `/Users/username/.config/mcp-google-workspace`)
 9. Note your OAuth Client ID and Client Secret. They must be provided as environment variables along with your configuration directory.
 10. You will also need to setup a .env file within the project with the following fields. You can find the Client ID and Client Secret in the Credentials section of the Google Cloud Console.
 
-```
-GDRIVE_CREDS_DIR=/path/to/config/directory
+```bash
+GWORKSPACE_CREDS_DIR=/path/to/config/directory
 CLIENT_ID=<CLIENT_ID>
 CLIENT_SECRET=<CLIENT_SECRET>
 ```
@@ -101,9 +94,7 @@ Next you will need to run `node ./dist/index.js` to trigger the authentication s
 
 You will be prompted to authenticate with your browser. You must authenticate with an account in the same organization as your Google Cloud project.
 
-Your OAuth token is saved in the directory specified by the `GDRIVE_CREDS_DIR` environment variable.
-
-![Authentication Prompt](https://i.imgur.com/TbyV6Yq.png)
+Your OAuth token is saved in the directory specified by the `GWORKSPACE_CREDS_DIR` environment variable.
 
 ### Usage with Desktop App
 
@@ -118,13 +109,28 @@ To integrate this server with the desktop app, add the following to your app's s
       "env": {
         "CLIENT_ID": "<CLIENT_ID>",
         "CLIENT_SECRET": "<CLIENT_SECRET>",
-        "GDRIVE_CREDS_DIR": "/path/to/config/directory"
+        "GWORKSPACE_CREDS_DIR": "/path/to/config/directory"
       }
     }
   }
 }
 ```
 
+### Usage with Claude Code CLI
+
+To add this server to Claude Code CLI, use the following command:
+
+```bash
+claude mcp add google-workspace \
+  -e CLIENT_ID=<YOUR_CLIENT_ID> \
+  -e CLIENT_SECRET=<YOUR_CLIENT_SECRET> \
+  -e GWORKSPACE_CREDS_DIR=/path/to/config/directory \
+  -- npx -y @alanse/mcp-server-google-workspace \
+  -s user
+```
+
+Replace `<YOUR_CLIENT_ID>`, `<YOUR_CLIENT_SECRET>`, and `/path/to/config/directory` with your actual values.
+
 ## 📈 Project Status
 
 ✅ **Phase 1-12 Complete** (2026-01-06)
@@ -151,23 +157,12 @@ To integrate this server with the desktop app, add the following to your app's s
 
 ## 📄 License
 
-This project is licensed under the **MIT License**.
-
-### Copyright Notices
-
-- Original code: © 2024 Anthropic, PBC
-- Base implementation: © 2024 Phil Isaac
-- Extended implementation: © 2026 Alanse株式会社 / Daichi Okazaki
-
-You are free to use, modify, and distribute this software under the terms of the MIT License. See the [LICENSE](./LICENSE) file for details.
-
-## 🙏 Acknowledgments
+This project is licensed under the **Elastic License 2.0**.
 
-Special thanks to:
-- **Anthropic, PBC** for the original MCP server implementation
-- **Phil Isaac** for the enhanced Google Drive & Sheets integration
-- The **Model Context Protocol** team for the excellent framework
+Copyright © 2026 Alanse inc.
 
-## 📚 Related Documentation
+See the [LICENSE](./LICENSE) file for details.
 
-- [docs/api-comparison.md](./docs/api-comparison.md) - MCP vs Google Sheets API comparison
+**Key restrictions**:
+- You may not provide the software to third parties as a hosted or managed service where the service provides users with access to any substantial set of the features or functionality of the software.
+- You may not alter, remove, or obscure any licensing, copyright, or other notices of the licensor in the software.

package/dist/auth.js

@@ -7,7 +7,7 @@ export const SCOPES = [
     "https://www.googleapis.com/auth/spreadsheets",
 ];
 // Get credentials directory from environment variable or use default
-const CREDS_DIR = process.env.GDRIVE_CREDS_DIR ||
+const CREDS_DIR = process.env.GWORKSPACE_CREDS_DIR ||
     path.join(path.dirname(new URL(import.meta.url).pathname), "../../../");
 // Ensure the credentials directory exists
 function ensureCredsDirectory() {
@@ -20,7 +20,7 @@ function ensureCredsDirectory() {
         throw error;
     }
 }
-const credentialsPath = path.join(CREDS_DIR, ".gdrive-server-credentials.json");
+const credentialsPath = path.join(CREDS_DIR, ".gworkspace-credentials.json");
 async function authenticateWithTimeout(keyfilePath, SCOPES, timeoutMs = 30000) {
     const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error("Authentication timed out")), timeoutMs));
     const authPromise = authenticate({

package/dist/index.js

@@ -8,12 +8,12 @@ import { getValidCredentials, setupTokenRefresh, loadCredentialsQuietly, } from
 import { tools } from "./tools/index.js";
 const drive = google.drive("v3");
 const server = new Server({
-    name: "example-servers/gdrive",
-    version: "0.1.0",
+    name: "@alanse/mcp-server-google-workspace",
+    version: "0.2.1",
 }, {
     capabilities: {
         resources: {
-            schemes: ["gdrive"], // Declare that we handle gdrive:/// URIs
+            schemes: ["gworkspace"], // Declare that we handle gworkspace:/// URIs
             listable: true, // Support listing available resources
             readable: true, // Support reading resource contents
         },
@@ -47,7 +47,7 @@ server.setRequestHandler(ListResourcesRequestSchema, async (request) => {
     const files = res.data.files;
     return {
         resources: files.map((file) => ({
-            uri: `gdrive:///${file.id}`,
+            uri: `gworkspace:///${file.id}`,
             mimeType: file.mimeType,
             name: file.name,
         })),
@@ -56,8 +56,8 @@ server.setRequestHandler(ListResourcesRequestSchema, async (request) => {
 });
 server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
     await ensureAuthQuietly();
-    const fileId = request.params.uri.replace("gdrive:///", "");
-    const readFileTool = tools[1]; // gdrive_read_file is the second tool
+    const fileId = request.params.uri.replace("gworkspace:///", "");
+    const readFileTool = tools[1]; // drive_read_file is the second tool
     const result = await readFileTool.handler({ fileId });
     // Extract the file contents from the tool response
     const fileContents = result.content[0].text.split("\n\n")[1]; // Skip the "Contents of file:" prefix

package/dist/tools/drive/drive_read_file.js

@@ -0,0 +1,77 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "drive_read_file",
+    description: "Read contents of a file from Google Drive",
+    inputSchema: {
+        type: "object",
+        properties: {
+            fileId: {
+                type: "string",
+                description: "ID of the file to read",
+            },
+        },
+        required: ["fileId"],
+    },
+};
+const drive = google.drive("v3");
+export async function readFile(args) {
+    const result = await readGoogleDriveFile(args.fileId);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Contents of ${result.name}:\n\n${result.contents.text || result.contents.blob}`,
+            },
+        ],
+        isError: false,
+    };
+}
+async function readGoogleDriveFile(fileId) {
+    // First get file metadata to check mime type
+    const file = await drive.files.get({
+        fileId,
+        fields: "mimeType,name",
+    });
+    // For Google Docs/Sheets/etc we need to export
+    if (file.data.mimeType?.startsWith("application/vnd.google-apps")) {
+        let exportMimeType;
+        switch (file.data.mimeType) {
+            case "application/vnd.google-apps.document":
+                exportMimeType = "text/markdown";
+                break;
+            case "application/vnd.google-apps.spreadsheet":
+                exportMimeType = "text/csv";
+                break;
+            case "application/vnd.google-apps.presentation":
+                exportMimeType = "text/plain";
+                break;
+            case "application/vnd.google-apps.drawing":
+                exportMimeType = "image/png";
+                break;
+            default:
+                exportMimeType = "text/plain";
+        }
+        const res = await drive.files.export({ fileId, mimeType: exportMimeType }, { responseType: "text" });
+        return {
+            name: file.data.name || fileId,
+            contents: {
+                mimeType: exportMimeType,
+                text: res.data,
+            },
+        };
+    }
+    // For regular files download content
+    const res = await drive.files.get({ fileId, alt: "media" }, { responseType: "arraybuffer" });
+    const mimeType = file.data.mimeType || "application/octet-stream";
+    const isText = mimeType.startsWith("text/") || mimeType === "application/json";
+    const content = Buffer.from(res.data);
+    return {
+        name: file.data.name || fileId,
+        contents: {
+            mimeType,
+            ...(isText
+                ? { text: content.toString("utf-8") }
+                : { blob: content.toString("base64") }),
+        },
+    };
+}

package/dist/tools/drive/drive_search.js

@@ -0,0 +1,71 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "drive_search",
+    description: "Search for files in Google Drive",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Search query",
+            },
+            pageToken: {
+                type: "string",
+                description: "Token for the next page of results",
+                optional: true,
+            },
+            pageSize: {
+                type: "number",
+                description: "Number of results per page (max 100)",
+                optional: true,
+            },
+        },
+        required: ["query"],
+    },
+};
+export async function search(args) {
+    const drive = google.drive("v3");
+    const userQuery = args.query.trim();
+    let searchQuery = "";
+    // If query is empty, list all files
+    if (!userQuery) {
+        searchQuery = "trashed = false";
+    }
+    else {
+        // Escape special characters in the query
+        const escapedQuery = userQuery.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+        // Build search query with multiple conditions
+        const conditions = [];
+        // Search in title
+        conditions.push(`name contains '${escapedQuery}'`);
+        // If specific file type is mentioned in query, add mimeType condition
+        if (userQuery.toLowerCase().includes("sheet")) {
+            conditions.push("mimeType = 'application/vnd.google-sheets.spreadsheet'");
+        }
+        searchQuery = `(${conditions.join(" or ")}) and trashed = false`;
+    }
+    const res = await drive.files.list({
+        q: searchQuery,
+        pageSize: args.pageSize || 10,
+        pageToken: args.pageToken,
+        orderBy: "modifiedTime desc",
+        fields: "nextPageToken, files(id, name, mimeType, modifiedTime, size)",
+    });
+    const fileList = res.data.files
+        ?.map((file) => `${file.id} ${file.name} (${file.mimeType})`)
+        .join("\n");
+    let response = `Found ${res.data.files?.length ?? 0} files:\n${fileList}`;
+    // Add pagination info if there are more results
+    if (res.data.nextPageToken) {
+        response += `\n\nMore results available. Use pageToken: ${res.data.nextPageToken}`;
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: response,
+            },
+        ],
+        isError: false,
+    };
+}

package/dist/tools/index.js

@@ -1,6 +1,6 @@
-// GDrive operations
-import { schema as gdriveSearchSchema, search } from './gdrive/gdrive_search.js';
-import { schema as gdriveReadFileSchema, readFile } from './gdrive/gdrive_read_file.js';
+// Drive operations
+import { schema as driveSearchSchema, search } from './drive/drive_search.js';
+import { schema as driveReadFileSchema, readFile } from './drive/drive_read_file.js';
 // Basic operations
 import { schema as gsheetsReadSchema, readSheet } from './sheets/basic/gsheets_read.js';
 import { schema as gsheetsListSheetsSchema, listSheets } from './sheets/basic/gsheets_list_sheets.js';
@@ -64,11 +64,11 @@ import { schema as gsheetsUpdateDeveloperMetadataSchema, updateDeveloperMetadata
 import { schema as gsheetsDeleteDeveloperMetadataSchema, deleteDeveloperMetadata } from './sheets/advanced/gsheets_delete_developer_metadata.js';
 export const tools = [
     {
-        ...gdriveSearchSchema,
+        ...driveSearchSchema,
         handler: search,
     },
     {
-        ...gdriveReadFileSchema,
+        ...driveReadFileSchema,
         handler: readFile,
     },
     {

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@alanse/mcp-server-google-workspace",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "The most comprehensive MCP server for Google Workspace - Complete integration for Sheets (57 tools), Drive, and future Docs, Calendar, Forms support",
-  "license": "MIT",
-  "author": "Alanse inc. / Daichi Okazaki",
+  "license": "Elastic-2.0",
+  "author": "Alanse inc",
   "homepage": "https://github.com/alanse-inc/mcp-server-google-workspace",
   "bugs": "https://github.com/alanse-inc/mcp-server-google-workspace/issues",
   "type": "module",