gogcli-mcp 4.2.1 → 4.2.3

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
-    "version": "4.2.1"
+    "version": "4.2.3"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "gogcli",
       "source": "./",
       "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
-      "version": "4.2.1",
+      "version": "4.2.3",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gogcli-mcp",
   "displayName": "gogcli",
-  "version": "4.2.1",
+  "version": "4.2.3",
   "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
   "author": {
     "name": "Chris Hall",

package/dist/index.js

@@ -35530,6 +35530,7 @@ function registerAppScriptTools(server) {
   });
   server.registerTool("gog_appscript_create", {
     description: "Create a new, empty Apps Script project. Pass parentId to bind it to a Drive file (a Sheet, Doc or Form), which is what makes the script a container-bound script with access to that document; omit it for a standalone project. gog cannot upload code, so the project starts empty either way." + apiEnableNote,
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       title: external_exports.string().describe("Project title"),
       parentId: external_exports.string().optional().describe("Drive file ID to bind the project to (Sheet, Doc or Form). Omit for a standalone project."),
@@ -35670,6 +35671,7 @@ function registerAuthToolsWith(server, defaultServices) {
   });
   server.registerTool("gog_auth_add_url", {
     description: "Begin REMOTE/headless Google authorization (step 1 of 2). Returns a sign-in URL to open in any browser \u2014 no local server or terminal on the gogcli host is needed, so this works on a hosted deployment where the interactive gog_auth_add cannot. Hand the URL to the user; after they sign in, the browser is redirected to a localhost URL that fails to load \u2014 that is expected. They copy that full redirected URL (from the address bar) and you pass it to gog_auth_add_complete. The link is valid for 10 minutes. If you pass a custom `services` here, pass the SAME value to gog_auth_add_complete or the second step will not match this one.",
+    annotations: { readOnlyHint: true },
     inputSchema: external_exports.object({
       email: external_exports.string().describe("Google account email to authorize"),
       services: external_exports.string().optional().default(defaultServices).describe(servicesDescribe),
@@ -36030,6 +36032,7 @@ function registerChatTools(server) {
   });
   server.registerTool("gog_chat_spaces_create", {
     description: "Create a named Chat space, optionally seeding its membership. Members are added immediately and are notified \u2014 this is visible to other people the moment it runs, so confirm the member list before calling it." + workspaceOnlyNote,
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       displayName: external_exports.string().describe("Display name for the new space"),
       members: external_exports.array(external_exports.string()).optional().describe('Initial members, as email addresses or "users/..." resource names'),
@@ -36098,6 +36101,7 @@ function registerChatTools(server) {
   });
   server.registerTool("gog_chat_messages_send", {
     description: "Post a message to a Chat space. THIS IS IMMEDIATELY VISIBLE TO EVERYONE IN THE SPACE and cannot be unsent through this tool, so treat it like sending mail, not like saving a draft. Pass `thread` to reply inside an existing conversation (from gog_chat_threads_list or a message's thread field); omit it to start a new one. Text supports Chat's markdown-ish formatting (*bold*, _italic_, `code`)." + workspaceOnlyNote,
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       space: spaceParam,
       text: external_exports.string().optional().describe("Message text. Optional only when an attachment is supplied."),
@@ -36121,6 +36125,7 @@ function registerChatTools(server) {
   });
   server.registerTool("gog_chat_dm_send", {
     description: "Send a direct message to one person by email address, creating the DM space if this is the first message. Delivered immediately and cannot be unsent through this tool. For a room rather than a person, use gog_chat_messages_send." + workspaceOnlyNote,
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       email: external_exports.string().describe("Recipient email address"),
       text: external_exports.string().describe("Message text"),
@@ -36134,6 +36139,7 @@ function registerChatTools(server) {
   });
   server.registerTool("gog_chat_dm_space", {
     description: 'Resolve the DM space for an email address \u2014 the bridge from a person to the "spaces/..." name the message tools want. Creates the space if none exists yet, which is silent: it does not message the person.' + workspaceOnlyNote,
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       email: external_exports.string().describe("The other person's email address"),
       account: accountParam
@@ -36606,7 +36612,7 @@ function registerContactsTools(server) {
   });
   server.registerTool("gog_contacts_create", {
     description: "Create a new Google Contact.",
-    annotations: { destructiveHint: false },
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       givenName: external_exports.string().describe("Given (first) name"),
       familyName: external_exports.string().optional().describe("Family (last) name"),
@@ -36655,6 +36661,7 @@ function registerDocsTools(server) {
   });
   server.registerTool("gog_docs_create", {
     description: "Create a new Google Doc. Returns JSON with the new docId and URL.",
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       title: external_exports.string().describe("Title for the new document"),
       account: accountParam
@@ -36814,7 +36821,7 @@ function registerDriveTools(server) {
   });
   server.registerTool("gog_drive_rename", {
     description: "Rename a file or folder in Google Drive.",
-    annotations: { destructiveHint: true },
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       fileId: external_exports.string().describe("File or folder ID"),
       newName: external_exports.string().describe("New name"),
@@ -36825,7 +36832,7 @@ function registerDriveTools(server) {
   });
   server.registerTool("gog_drive_move", {
     description: "Move a file to a different folder in Google Drive.",
-    annotations: { destructiveHint: true },
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       fileId: external_exports.string().describe("File ID to move"),
       parentId: external_exports.string().describe("Destination folder ID"),
@@ -37491,7 +37498,7 @@ function registerSheetsTools(server) {
   });
   server.registerTool("gog_sheets_create", {
     description: "Create a new Google Spreadsheet. Returns JSON with the new spreadsheetId and URL.",
-    annotations: { destructiveHint: false },
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       title: external_exports.string().describe("Title for the new spreadsheet"),
       account: accountParam
@@ -37545,6 +37552,7 @@ function registerSlidesTools(server) {
   });
   server.registerTool("gog_slides_create", {
     description: "Create a new Google Slides presentation, optionally in a folder or copying from a template.",
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       title: external_exports.string().describe("Presentation title"),
       parent: external_exports.string().optional().describe("Destination folder ID"),
@@ -37559,6 +37567,7 @@ function registerSlidesTools(server) {
   });
   server.registerTool("gog_slides_copy", {
     description: "Copy a Google Slides presentation to a new presentation with the given title.",
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       presentationId: external_exports.string().describe("Presentation ID to copy"),
       title: external_exports.string().describe("Title for the new copy"),
@@ -37647,7 +37656,7 @@ function registerTasksTools(server) {
   });
   server.registerTool("gog_tasks_done", {
     description: "Mark a task as completed.",
-    annotations: { destructiveHint: true },
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       tasklistId: external_exports.string().describe("Task list ID"),
       taskId: external_exports.string().describe("Task ID"),
@@ -37671,7 +37680,7 @@ function registerTasksTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "4.2.1" : "0.0.0";
+var VERSION = true ? "4.2.3" : "0.0.0";
 var BASE_TOOL_REGISTRARS = [
   registerApiTools,
   registerAppScriptTools,

package/dist/lib.js

@@ -33861,6 +33861,7 @@ function registerAppScriptTools(server) {
   });
   server.registerTool("gog_appscript_create", {
     description: "Create a new, empty Apps Script project. Pass parentId to bind it to a Drive file (a Sheet, Doc or Form), which is what makes the script a container-bound script with access to that document; omit it for a standalone project. gog cannot upload code, so the project starts empty either way." + apiEnableNote,
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       title: external_exports.string().describe("Project title"),
       parentId: external_exports.string().optional().describe("Drive file ID to bind the project to (Sheet, Doc or Form). Omit for a standalone project."),
@@ -34001,6 +34002,7 @@ function registerAuthToolsWith(server, defaultServices) {
   });
   server.registerTool("gog_auth_add_url", {
     description: "Begin REMOTE/headless Google authorization (step 1 of 2). Returns a sign-in URL to open in any browser \u2014 no local server or terminal on the gogcli host is needed, so this works on a hosted deployment where the interactive gog_auth_add cannot. Hand the URL to the user; after they sign in, the browser is redirected to a localhost URL that fails to load \u2014 that is expected. They copy that full redirected URL (from the address bar) and you pass it to gog_auth_add_complete. The link is valid for 10 minutes. If you pass a custom `services` here, pass the SAME value to gog_auth_add_complete or the second step will not match this one.",
+    annotations: { readOnlyHint: true },
     inputSchema: external_exports.object({
       email: external_exports.string().describe("Google account email to authorize"),
       services: external_exports.string().optional().default(defaultServices).describe(servicesDescribe),
@@ -34364,6 +34366,7 @@ function registerChatTools(server) {
   });
   server.registerTool("gog_chat_spaces_create", {
     description: "Create a named Chat space, optionally seeding its membership. Members are added immediately and are notified \u2014 this is visible to other people the moment it runs, so confirm the member list before calling it." + workspaceOnlyNote,
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       displayName: external_exports.string().describe("Display name for the new space"),
       members: external_exports.array(external_exports.string()).optional().describe('Initial members, as email addresses or "users/..." resource names'),
@@ -34432,6 +34435,7 @@ function registerChatTools(server) {
   });
   server.registerTool("gog_chat_messages_send", {
     description: "Post a message to a Chat space. THIS IS IMMEDIATELY VISIBLE TO EVERYONE IN THE SPACE and cannot be unsent through this tool, so treat it like sending mail, not like saving a draft. Pass `thread` to reply inside an existing conversation (from gog_chat_threads_list or a message's thread field); omit it to start a new one. Text supports Chat's markdown-ish formatting (*bold*, _italic_, `code`)." + workspaceOnlyNote,
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       space: spaceParam,
       text: external_exports.string().optional().describe("Message text. Optional only when an attachment is supplied."),
@@ -34455,6 +34459,7 @@ function registerChatTools(server) {
   });
   server.registerTool("gog_chat_dm_send", {
     description: "Send a direct message to one person by email address, creating the DM space if this is the first message. Delivered immediately and cannot be unsent through this tool. For a room rather than a person, use gog_chat_messages_send." + workspaceOnlyNote,
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       email: external_exports.string().describe("Recipient email address"),
       text: external_exports.string().describe("Message text"),
@@ -34468,6 +34473,7 @@ function registerChatTools(server) {
   });
   server.registerTool("gog_chat_dm_space", {
     description: 'Resolve the DM space for an email address \u2014 the bridge from a person to the "spaces/..." name the message tools want. Creates the space if none exists yet, which is silent: it does not message the person.' + workspaceOnlyNote,
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       email: external_exports.string().describe("The other person's email address"),
       account: accountParam
@@ -34940,7 +34946,7 @@ function registerContactsTools(server) {
   });
   server.registerTool("gog_contacts_create", {
     description: "Create a new Google Contact.",
-    annotations: { destructiveHint: false },
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       givenName: external_exports.string().describe("Given (first) name"),
       familyName: external_exports.string().optional().describe("Family (last) name"),
@@ -34989,6 +34995,7 @@ function registerDocsTools(server) {
   });
   server.registerTool("gog_docs_create", {
     description: "Create a new Google Doc. Returns JSON with the new docId and URL.",
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       title: external_exports.string().describe("Title for the new document"),
       account: accountParam
@@ -35148,7 +35155,7 @@ function registerDriveTools(server) {
   });
   server.registerTool("gog_drive_rename", {
     description: "Rename a file or folder in Google Drive.",
-    annotations: { destructiveHint: true },
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       fileId: external_exports.string().describe("File or folder ID"),
       newName: external_exports.string().describe("New name"),
@@ -35159,7 +35166,7 @@ function registerDriveTools(server) {
   });
   server.registerTool("gog_drive_move", {
     description: "Move a file to a different folder in Google Drive.",
-    annotations: { destructiveHint: true },
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       fileId: external_exports.string().describe("File ID to move"),
       parentId: external_exports.string().describe("Destination folder ID"),
@@ -35825,7 +35832,7 @@ function registerSheetsTools(server) {
   });
   server.registerTool("gog_sheets_create", {
     description: "Create a new Google Spreadsheet. Returns JSON with the new spreadsheetId and URL.",
-    annotations: { destructiveHint: false },
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       title: external_exports.string().describe("Title for the new spreadsheet"),
       account: accountParam
@@ -35879,6 +35886,7 @@ function registerSlidesTools(server) {
   });
   server.registerTool("gog_slides_create", {
     description: "Create a new Google Slides presentation, optionally in a folder or copying from a template.",
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       title: external_exports.string().describe("Presentation title"),
       parent: external_exports.string().optional().describe("Destination folder ID"),
@@ -35893,6 +35901,7 @@ function registerSlidesTools(server) {
   });
   server.registerTool("gog_slides_copy", {
     description: "Copy a Google Slides presentation to a new presentation with the given title.",
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       presentationId: external_exports.string().describe("Presentation ID to copy"),
       title: external_exports.string().describe("Title for the new copy"),
@@ -35981,7 +35990,7 @@ function registerTasksTools(server) {
   });
   server.registerTool("gog_tasks_done", {
     description: "Mark a task as completed.",
-    annotations: { destructiveHint: true },
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       tasklistId: external_exports.string().describe("Task list ID"),
       taskId: external_exports.string().describe("Task ID"),
@@ -36005,7 +36014,7 @@ function registerTasksTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "4.2.1" : "0.0.0";
+var VERSION = true ? "4.2.3" : "0.0.0";
 var BASE_TOOL_REGISTRARS = [
   registerApiTools,
   registerAppScriptTools,

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp",
   "display_name": "gogcli",
-  "version": "4.2.1",
+  "version": "4.2.3",
   "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
   "author": {
     "name": "Chris Hall",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp",
-  "version": "4.2.1",
+  "version": "4.2.3",
   "mcpName": "io.github.chrischall/gogcli-mcp",
   "description": "MCP server wrapping gogcli for Google service access",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

@@ -7,12 +7,12 @@
     "source": "github",
     "subfolder": "packages/gogcli-mcp"
   },
-  "version": "4.2.1",
+  "version": "4.2.3",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "gogcli-mcp",
-      "version": "4.2.1",
+      "version": "4.2.3",
       "transport": {
         "type": "stdio"
       },

package/src/tools/appscript.ts

@@ -82,6 +82,7 @@ export function registerAppScriptTools(server: McpServer): void {
       'Create a new, empty Apps Script project. Pass parentId to bind it to a Drive file (a Sheet, Doc or Form), which is '
       + 'what makes the script a container-bound script with access to that document; omit it for a standalone project. '
       + 'gog cannot upload code, so the project starts empty either way.' + apiEnableNote,
+    annotations: { destructiveHint: true },
     inputSchema: z.object({
       title: z.string().describe('Project title'),
       parentId: z.string().optional().describe('Drive file ID to bind the project to (Sheet, Doc or Form). Omit for a standalone project.'),

package/src/tools/auth.ts

@@ -135,6 +135,7 @@ function registerAuthToolsWith(server: McpServer, defaultServices: string): void
       'full redirected URL (from the address bar) and you pass it to gog_auth_add_complete. The link is ' +
       'valid for 10 minutes. If you pass a custom `services` here, pass the SAME value to ' +
       'gog_auth_add_complete or the second step will not match this one.',
+    annotations: { readOnlyHint: true },
     inputSchema: z.object({
       email: z.string().describe('Google account email to authorize'),
       services: z.string().optional().default(defaultServices).describe(servicesDescribe),

package/src/tools/chat.ts

@@ -82,6 +82,7 @@ export function registerChatTools(server: McpServer): void {
     description:
       'Create a named Chat space, optionally seeding its membership. Members are added immediately and are notified — this '
       + 'is visible to other people the moment it runs, so confirm the member list before calling it.' + workspaceOnlyNote,
+    annotations: { destructiveHint: true },
     inputSchema: z.object({
       displayName: z.string().describe('Display name for the new space'),
       members: z.array(z.string()).optional().describe('Initial members, as email addresses or "users/..." resource names'),
@@ -176,6 +177,7 @@ export function registerChatTools(server: McpServer): void {
       + 'this tool, so treat it like sending mail, not like saving a draft. Pass `thread` to reply inside an existing '
       + 'conversation (from gog_chat_threads_list or a message\'s thread field); omit it to start a new one. Text supports '
       + 'Chat\'s markdown-ish formatting (*bold*, _italic_, `code`).' + workspaceOnlyNote,
+    annotations: { destructiveHint: true },
     inputSchema: z.object({
       space: spaceParam,
       text: z.string().optional().describe('Message text. Optional only when an attachment is supplied.'),
@@ -207,6 +209,7 @@ export function registerChatTools(server: McpServer): void {
       'Send a direct message to one person by email address, creating the DM space if this is the first message. Delivered '
       + 'immediately and cannot be unsent through this tool. For a room rather than a person, use gog_chat_messages_send.'
       + workspaceOnlyNote,
+    annotations: { destructiveHint: true },
     inputSchema: z.object({
       email: z.string().describe('Recipient email address'),
       text: z.string().describe('Message text'),
@@ -223,6 +226,7 @@ export function registerChatTools(server: McpServer): void {
     description:
       'Resolve the DM space for an email address — the bridge from a person to the "spaces/..." name the message tools '
       + 'want. Creates the space if none exists yet, which is silent: it does not message the person.' + workspaceOnlyNote,
+    annotations: { destructiveHint: true },
     inputSchema: z.object({
       email: z.string().describe('The other person\'s email address'),
       account: accountParam,

package/src/tools/contacts.ts

@@ -37,7 +37,7 @@ export function registerContactsTools(server: McpServer): void {
 
   server.registerTool('gog_contacts_create', {
     description: 'Create a new Google Contact.',
-    annotations: { destructiveHint: false },
+    annotations: { destructiveHint: true },
     inputSchema: z.object({
       givenName: z.string().describe('Given (first) name'),
       familyName: z.string().optional().describe('Family (last) name'),

package/src/tools/docs.ts

@@ -30,6 +30,7 @@ export function registerDocsTools(server: McpServer): void {
 
   server.registerTool('gog_docs_create', {
     description: 'Create a new Google Doc. Returns JSON with the new docId and URL.',
+    annotations: { destructiveHint: true },
     inputSchema: z.object({
       title: z.string().describe('Title for the new document'),
       account: accountParam,

package/src/tools/drive.ts

@@ -118,7 +118,7 @@ export function registerDriveTools(server: McpServer): void {
 
   server.registerTool('gog_drive_rename', {
     description: 'Rename a file or folder in Google Drive.',
-    annotations: { destructiveHint: true },
+    annotations: { destructiveHint: false },
     inputSchema: z.object({
       fileId: z.string().describe('File or folder ID'),
       newName: z.string().describe('New name'),
@@ -130,7 +130,7 @@ export function registerDriveTools(server: McpServer): void {
 
   server.registerTool('gog_drive_move', {
     description: 'Move a file to a different folder in Google Drive.',
-    annotations: { destructiveHint: true },
+    annotations: { destructiveHint: false },
     inputSchema: z.object({
       fileId: z.string().describe('File ID to move'),
       parentId: z.string().describe('Destination folder ID'),

package/src/tools/sheets.ts

@@ -120,7 +120,7 @@ export function registerSheetsTools(server: McpServer): void {
 
   server.registerTool('gog_sheets_create', {
     description: 'Create a new Google Spreadsheet. Returns JSON with the new spreadsheetId and URL.',
-    annotations: { destructiveHint: false },
+    annotations: { destructiveHint: true },
     inputSchema: z.object({
       title: z.string().describe('Title for the new spreadsheet'),
       account: accountParam,

package/src/tools/slides.ts

@@ -34,6 +34,7 @@ export function registerSlidesTools(server: McpServer): void {
 
   server.registerTool('gog_slides_create', {
     description: 'Create a new Google Slides presentation, optionally in a folder or copying from a template.',
+    annotations: { destructiveHint: true },
     inputSchema: z.object({
       title: z.string().describe('Presentation title'),
       parent: z.string().optional().describe('Destination folder ID'),
@@ -49,6 +50,7 @@ export function registerSlidesTools(server: McpServer): void {
 
   server.registerTool('gog_slides_copy', {
     description: 'Copy a Google Slides presentation to a new presentation with the given title.',
+    annotations: { destructiveHint: true },
     inputSchema: z.object({
       presentationId: z.string().describe('Presentation ID to copy'),
       title: z.string().describe('Title for the new copy'),

package/src/tools/tasks.ts

@@ -55,7 +55,7 @@ export function registerTasksTools(server: McpServer): void {
 
   server.registerTool('gog_tasks_done', {
     description: 'Mark a task as completed.',
-    annotations: { destructiveHint: true },
+    annotations: { destructiveHint: false },
     inputSchema: z.object({
       tasklistId: z.string().describe('Task list ID'),
       taskId: z.string().describe('Task ID'),