gmcp 0.2.1 → 0.4.0

package/README.md

@@ -10,7 +10,6 @@
 <p align="center">
 <a href="https://www.npmjs.com/package/gmcp" rel="nofollow"><img src="https://img.shields.io/npm/v/gmcp.svg" alt="npm"></a>
 <a href="https://hub.docker.com/r/johnie/gmcp" rel="nofollow"><img src="https://img.shields.io/docker/pulls/johnie/gmcp" alt="Docker Pulls"></a>
-<a href="https://opensource.org/licenses/MIT" rel="nofollow"><img src="https://img.shields.io/github/license/johnie/gmcp" alt="License"></a>
 <a href="https://github.com/johnie/gmcp" rel="nofollow"><img src="https://img.shields.io/github/stars/johnie/gmcp" alt="stars"></a>
 </p>
 
@@ -61,10 +60,10 @@ bun install
 
 ```bash
 # If installed globally
-gmcp-auth
+gmcp auth
 
 # Or with npx
-npx gmcp-auth
+npx gmcp auth
 
 # Or from source
 bun run auth
@@ -76,10 +75,11 @@ Follow the prompts to authorize. The browser will show "connection refused" afte
 
 ```bash
 # Globally installed
-gmcp
+gmcp start
+# or just: gmcp
 
 # With npx
-npx gmcp
+npx gmcp start
 
 # From source
 bun run start
@@ -135,7 +135,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
   "mcpServers": {
     "gmcp": {
       "command": "bun",
-      "args": ["run", "/path/to/gmcp/src/index.ts"],
+      "args": ["run", "/path/to/gmcp/src/cli.ts"],
       "env": {
         "GOOGLE_CREDENTIALS_PATH": "/path/to/credentials.json",
         "GOOGLE_TOKEN_PATH": "/path/to/token.json",
@@ -148,7 +148,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 
 ## Tools
 
-### Gmail (15 tools)
+### Gmail (16 tools)
 
 | Tool | Description |
 |------|-------------|
@@ -160,6 +160,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 | `gmcp_gmail_send_email` | Send new email |
 | `gmcp_gmail_reply` | Reply to email in thread |
 | `gmcp_gmail_create_draft` | Create draft message |
+| `gmcp_gmail_delete_email` | Permanently delete email (bypasses trash) |
 | `gmcp_gmail_list_labels` | List all labels |
 | `gmcp_gmail_get_label` | Get label details |
 | `gmcp_gmail_create_label` | Create custom label |
@@ -193,7 +194,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 |-------|--------|
 | `gmail.readonly` | Read emails and labels |
 | `gmail.send` | Send emails |
-| `gmail.modify` | Read, modify labels |
+| `gmail.modify` | Read, modify labels, delete emails |
 | `gmail.labels` | Manage labels |
 | `gmail.compose` | Create drafts and send |
 | `calendar.readonly` | Read calendars and events |
@@ -210,6 +211,20 @@ GOOGLE_SCOPES=gmail.readonly,calendar.readonly
 GOOGLE_SCOPES=gmail.readonly,gmail.modify,gmail.send,calendar.events
 ```
 
+## CLI Reference
+
+```
+gmcp [command]
+
+Commands:
+  start    Start MCP server (default)
+  auth     Run OAuth2 authentication flow
+
+Options:
+  --help, -h       Show usage
+  --version, -v    Show version
+```
+
 ## Testing
 
 ```bash

package/dist/auth-cli.js

@@ -10,19 +10,8 @@ import {
 import"./shared/chunk-3s189drz.js";
 
 // src/auth-cli.ts
-import { createInterface } from "node:readline";
-function readLine() {
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-  return new Promise((resolve) => {
-    rl.on("line", (line) => {
-      rl.close();
-      resolve(line.trim());
-    });
-  });
-}
+import { input } from "@inquirer/prompts";
+import kleur from "kleur";
 async function runAuth() {
   console.log(`GMCP Server - OAuth2 Authentication
 `);
@@ -39,7 +28,7 @@ async function runAuth() {
 ========================================`);
   console.log("STEP 1: Visit this URL to authorize:");
   console.log("========================================");
-  console.log("\x1B[36m%s\x1B[0m", authUrl);
+  console.log(kleur.cyan(authUrl));
   console.log(`
 ========================================`);
   console.log("STEP 2: After authorizing:");
@@ -54,24 +43,30 @@ Copy the entire code after "code=" (the long string before "&scope")`);
   console.log(`
 ========================================`);
   console.log("STEP 3: Paste the authorization code below:");
-  console.log("========================================");
-  const code = await readLine();
-  if (!code) {
-    console.error("Error: No authorization code provided");
-    process.exit(1);
-  }
+  console.log(`========================================
+`);
+  const code = await input({
+    message: "Authorization code:",
+    required: true,
+    validate: (value) => {
+      if (value.length < 10) {
+        return "Authorization code appears too short";
+      }
+      return true;
+    }
+  });
   console.log(`
 Exchanging authorization code for tokens...`);
   try {
     const tokens = await getTokensFromCode(oauth2Client, code);
     await saveTokens(tokenPath, tokens);
-    console.log("\x1B[32m%s\x1B[0m", `
-Success! Tokens saved to`, tokenPath);
+    console.log(kleur.green(`
+Success! Tokens saved to ${tokenPath}`));
     console.log(`
 You can now run the MCP server with: npx gmcp`);
   } catch (error) {
-    console.error("\x1B[31m%s\x1B[0m", `
-Error exchanging code for tokens:`);
+    console.error(kleur.red(`
+Error exchanging code for tokens:`));
     console.error(error);
     process.exit(1);
   }

package/dist/cli.js

@@ -7,56 +7,51 @@ import {
 } from "./shared/chunk-3s189drz.js";
 
 // src/cli.ts
-var USAGE = `
-Usage: gmcp [command]
+import { run } from "@stricli/core";
 
-Commands:
-  start    Start the MCP server (default)
-  auth     Run OAuth2 authentication flow
+// src/cli/app.ts
+import { buildApplication, buildRouteMap } from "@stricli/core";
 
-Options:
-  --help, -h       Show this help message
-  --version, -v    Show version number
+// src/cli/commands/auth.ts
+import { buildCommand } from "@stricli/core";
+var authCommand = buildCommand({
+  func: async () => {
+    const { runAuth } = await import("./auth-cli.js");
+    await runAuth();
+  },
+  parameters: {},
+  docs: { brief: "Run OAuth2 authentication flow" }
+});
 
-Examples:
-  npx gmcp         Start the MCP server
-  npx gmcp start   Start the MCP server
-  npx gmcp auth    Run OAuth2 authentication
-`.trim();
-function showHelp() {
-  console.log(USAGE);
-}
-async function showVersion() {
-  const version = await getVersion();
-  console.log(`gmcp v${version}`);
-}
-async function main() {
-  const args = process.argv.slice(2);
-  const command = args[0];
-  if (command === "--help" || command === "-h") {
-    showHelp();
-    return;
-  }
-  if (command === "--version" || command === "-v") {
-    await showVersion();
-    return;
-  }
-  if (!command || command === "start") {
+// src/cli/commands/start.ts
+import { buildCommand as buildCommand2 } from "@stricli/core";
+var startCommand = buildCommand2({
+  func: async () => {
     const { startServer } = await import("./index.js");
     await startServer();
-    return;
-  }
-  if (command === "auth") {
-    const { runAuth } = await import("./auth-cli.js");
-    await runAuth();
-    return;
-  }
-  console.error(`Unknown command: ${command}
-`);
-  showHelp();
-  process.exit(1);
-}
-main().catch((error) => {
-  console.error("Fatal error:", error);
-  process.exit(1);
+  },
+  parameters: {},
+  docs: { brief: "Start the MCP server" }
+});
+
+// src/cli/app.ts
+var routes = buildRouteMap({
+  routes: {
+    start: startCommand,
+    auth: authCommand
+  },
+  docs: { brief: "GMCP - Gmail and Calendar MCP Server" }
 });
+async function createApp() {
+  const version = await getVersion();
+  return buildApplication(routes, {
+    name: "gmcp",
+    versionInfo: { currentVersion: version }
+  });
+}
+
+// src/cli.ts
+var app = await createApp();
+var args = process.argv.slice(2);
+var effectiveArgs = args.length === 0 ? ["start"] : args;
+await run(app, effectiveArgs, { process });

package/dist/index.js

@@ -647,6 +647,16 @@ function createGmailClient(auth, logger) {
       } catch (error) {
         throw new Error(`Failed to delete label ${labelId}: ${error}`);
       }
+    },
+    async deleteEmail(messageId) {
+      try {
+        await gmail.users.messages.delete({
+          userId: "me",
+          id: messageId
+        });
+      } catch (error) {
+        throw new Error(`Failed to delete message ${messageId}: ${error}`);
+      }
     }
   };
 }
@@ -1760,9 +1770,88 @@ This tool creates a new label with customizable visibility and color settings. L
 **Scope Requirements**:
 - Requires \`gmail.labels\` or \`gmail.modify\` scope`;
 
-// src/tools/delete-label.ts
+// src/tools/delete-email.ts
 import json2md5 from "json2md";
 import { z as z8 } from "zod";
+var DeleteEmailInputSchema = z8.object({
+  message_id: z8.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to permanently delete"),
+  output_format: z8.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+});
+function deletionToMarkdown(messageId) {
+  const sections = [
+    { h1: "Email Deleted Successfully" },
+    {
+      p: `Message with ID **${messageId}** has been permanently deleted from your Gmail account.`
+    },
+    { h2: "Important Notes" },
+    {
+      ul: [
+        "The email has been permanently deleted (not moved to trash)",
+        "This action cannot be undone",
+        "The email cannot be recovered"
+      ]
+    }
+  ];
+  return json2md5(sections);
+}
+async function deleteEmailTool(gmailClient, params) {
+  try {
+    await gmailClient.deleteEmail(params.message_id);
+    const output = {
+      message_id: params.message_id,
+      deleted: true,
+      message: "Email permanently deleted. This action cannot be undone."
+    };
+    const textContent = params.output_format === "json" ? JSON.stringify(output, null, 2) : deletionToMarkdown(params.message_id);
+    return {
+      content: [{ type: "text", text: textContent }],
+      structuredContent: output
+    };
+  } catch (error) {
+    return createErrorResponse("deleting email", error);
+  }
+}
+var DELETE_EMAIL_DESCRIPTION = `Permanently delete a Gmail email message.
+
+**WARNING: This is a destructive operation that CANNOT be undone. The email is permanently deleted and bypasses the trash folder.**
+
+This tool permanently deletes an email message from your Gmail account. Unlike moving to trash, this operation immediately and permanently removes the email.
+
+**Parameters**:
+- \`message_id\` (string, required): The Gmail message ID to delete
+- \`output_format\` (string, optional): Output format: "markdown" (default) or "json"
+
+**Returns**:
+- \`message_id\`: The deleted message ID
+- \`deleted\`: Always true on success
+- \`message\`: Confirmation message
+
+**Examples**:
+- Delete email: \`{ "message_id": "18f3c5d4e8a2b1c0" }\`
+- Delete with JSON output: \`{ "message_id": "18f3c5d4e8a2b1c0", "output_format": "json" }\`
+
+**Safety Considerations**:
+- This is a destructive operation marked with \`destructiveHint: true\`
+- The email is permanently deleted, not moved to trash
+- This action cannot be undone - the email cannot be recovered
+- Consider using \`modify_labels\` with \`add_labels: ["TRASH"]\` if you want recoverable deletion
+- Use \`get_email\` first to verify which email you're deleting
+
+**Use Cases**:
+- Permanently remove sensitive emails
+- Clean up emails that should not be recoverable
+- Remove emails that are already in trash permanently
+
+**Error Handling**:
+- Returns error if message ID doesn't exist
+- Returns error if authentication lacks sufficient permissions
+
+**Scope Requirements**:
+- Requires \`gmail.modify\` or full \`mail.google.com\` scope`;
+
+// src/tools/delete-label.ts
+import json2md6 from "json2md";
+import { z as z9 } from "zod";
 var SYSTEM_LABELS = [
   "INBOX",
   "SENT",
@@ -1778,11 +1867,11 @@ var SYSTEM_LABELS = [
   "CATEGORY_UPDATES",
   "CATEGORY_FORUMS"
 ];
-var DeleteLabelInputSchema = z8.object({
-  label_id: z8.string().min(1, "Label ID cannot be empty").describe("The label ID to delete (e.g., 'Label_123'). Cannot delete system labels."),
-  output_format: z8.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+var DeleteLabelInputSchema = z9.object({
+  label_id: z9.string().min(1, "Label ID cannot be empty").describe("The label ID to delete (e.g., 'Label_123'). Cannot delete system labels."),
+  output_format: z9.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
-function deletionToMarkdown(labelId) {
+function deletionToMarkdown2(labelId) {
   const sections = [
     { h1: "Label Deleted Successfully" },
     {
@@ -1798,7 +1887,7 @@ function deletionToMarkdown(labelId) {
       ]
     }
   ];
-  return json2md5(sections);
+  return json2md6(sections);
 }
 async function deleteLabelTool(gmailClient, params) {
   try {
@@ -1830,7 +1919,7 @@ async function deleteLabelTool(gmailClient, params) {
       deleted: true,
       message: "Label deleted successfully. The label has been removed from all messages."
     };
-    const textContent = params.output_format === "json" ? JSON.stringify(output, null, 2) : deletionToMarkdown(params.label_id);
+    const textContent = params.output_format === "json" ? JSON.stringify(output, null, 2) : deletionToMarkdown2(params.label_id);
     return {
       content: [{ type: "text", text: textContent }],
       structuredContent: output
@@ -1920,11 +2009,11 @@ This tool permanently deletes a user-created label from your Gmail account. Syst
 If you want to hide a label instead of deleting it, consider using the \`update_label\` tool to set \`label_list_visibility\` to "labelHide" instead.`;
 
 // src/tools/get-attachment.ts
-import { z as z9 } from "zod";
-var GetAttachmentInputSchema = z9.object({
-  message_id: z9.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID containing the attachment"),
-  attachment_id: z9.string().min(1, "Attachment ID cannot be empty").describe("The attachment ID to download (from list_attachments)"),
-  output_format: z9.enum(["base64", "json"]).default("base64").describe("Output format: base64 (default, returns raw base64url string) or json (returns structured object)")
+import { z as z10 } from "zod";
+var GetAttachmentInputSchema = z10.object({
+  message_id: z10.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID containing the attachment"),
+  attachment_id: z10.string().min(1, "Attachment ID cannot be empty").describe("The attachment ID to download (from list_attachments)"),
+  output_format: z10.enum(["base64", "json"]).default("base64").describe("Output format: base64 (default, returns raw base64url string) or json (returns structured object)")
 });
 async function getAttachmentTool(gmailClient, params) {
   try {
@@ -1991,12 +2080,12 @@ To decode:
 3. Decode base64url data to get original file content`;
 
 // src/tools/get-email.ts
-import json2md6 from "json2md";
-import { z as z10 } from "zod";
-var GetEmailInputSchema = z10.object({
-  message_id: z10.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to retrieve"),
-  include_body: z10.boolean().default(true).describe("Whether to include full email body in results (default: true)"),
-  output_format: z10.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+import json2md7 from "json2md";
+import { z as z11 } from "zod";
+var GetEmailInputSchema = z11.object({
+  message_id: z11.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to retrieve"),
+  include_body: z11.boolean().default(true).describe("Whether to include full email body in results (default: true)"),
+  output_format: z11.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function emailToMarkdown(email) {
   const sections = [
@@ -2023,7 +2112,7 @@ function emailToMarkdown(email) {
     sections.push({ h2: "Snippet" });
     sections.push({ p: email.snippet });
   }
-  return json2md6(sections);
+  return json2md7(sections);
 }
 async function getEmailTool(gmailClient, params) {
   try {
@@ -2074,11 +2163,11 @@ This tool retrieves a specific email message from Gmail using its unique message
 - Retrieve email for further processing or analysis`;
 
 // src/tools/get-label.ts
-import json2md7 from "json2md";
-import { z as z11 } from "zod";
-var GetLabelInputSchema = z11.object({
-  label_id: z11.string().min(1, "Label ID cannot be empty").describe("The label ID to retrieve (e.g., 'INBOX', 'Label_123')"),
-  output_format: z11.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+import json2md8 from "json2md";
+import { z as z12 } from "zod";
+var GetLabelInputSchema = z12.object({
+  label_id: z12.string().min(1, "Label ID cannot be empty").describe("The label ID to retrieve (e.g., 'INBOX', 'Label_123')"),
+  output_format: z12.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function labelToMarkdown(label) {
   const sections = [
@@ -2113,7 +2202,7 @@ function labelToMarkdown(label) {
       ]
     });
   }
-  return json2md7(sections);
+  return json2md8(sections);
 }
 async function getLabelTool(gmailClient, params) {
   try {
@@ -2180,12 +2269,12 @@ This tool retrieves comprehensive details about a label, including its name, typ
 - System labels and custom labels are both supported`;
 
 // src/tools/get-thread.ts
-import json2md8 from "json2md";
-import { z as z12 } from "zod";
-var GetThreadInputSchema = z12.object({
-  thread_id: z12.string().min(1, "Thread ID cannot be empty").describe("The Gmail thread ID to retrieve"),
-  include_body: z12.boolean().default(false).describe("Whether to include full email body for all messages (default: false)"),
-  output_format: z12.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+import json2md9 from "json2md";
+import { z as z13 } from "zod";
+var GetThreadInputSchema = z13.object({
+  thread_id: z13.string().min(1, "Thread ID cannot be empty").describe("The Gmail thread ID to retrieve"),
+  include_body: z13.boolean().default(false).describe("Whether to include full email body for all messages (default: false)"),
+  output_format: z13.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function threadToMarkdown(threadId, messages) {
   const sections = [
@@ -2220,7 +2309,7 @@ function threadToMarkdown(threadId, messages) {
       sections.push({ p: "---" });
     }
   }
-  return json2md8(sections);
+  return json2md9(sections);
 }
 async function getThreadTool(gmailClient, params) {
   try {
@@ -2278,11 +2367,11 @@ This tool retrieves all messages in a Gmail conversation thread (email chain). T
 - Extract all messages from a discussion thread`;
 
 // src/tools/list-attachments.ts
-import json2md9 from "json2md";
-import { z as z13 } from "zod";
-var ListAttachmentsInputSchema = z13.object({
-  message_id: z13.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to list attachments from"),
-  output_format: z13.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+import json2md10 from "json2md";
+import { z as z14 } from "zod";
+var ListAttachmentsInputSchema = z14.object({
+  message_id: z14.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to list attachments from"),
+  output_format: z14.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function formatBytes(bytes) {
   if (bytes === 0) {
@@ -2314,7 +2403,7 @@ function attachmentsToMarkdown(messageId, attachments) {
       });
     }
   }
-  return json2md9(sections);
+  return json2md10(sections);
 }
 async function listAttachmentsTool(gmailClient, params) {
   try {
@@ -2372,10 +2461,10 @@ This tool retrieves metadata about all attachments in a specific email message,
 - List attachment IDs for use with get_attachment tool`;
 
 // src/tools/list-labels.ts
-import json2md10 from "json2md";
-import { z as z14 } from "zod";
-var ListLabelsInputSchema = z14.object({
-  output_format: z14.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+import json2md11 from "json2md";
+import { z as z15 } from "zod";
+var ListLabelsInputSchema = z15.object({
+  output_format: z15.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function labelsToMarkdown(labels) {
   const sections = [{ h1: "Gmail Labels" }];
@@ -2392,7 +2481,7 @@ function labelsToMarkdown(labels) {
   if (labels.system.length === 0 && labels.user.length === 0) {
     sections.push({ p: "*No labels found*" });
   }
-  return json2md10(sections);
+  return json2md11(sections);
 }
 async function listLabelsTool(gmailClient, params) {
   try {
@@ -2465,13 +2554,13 @@ Custom labels are created by users for organizing emails. They have IDs like \`L
 - Returns error if Gmail API is unreachable`;
 
 // src/tools/modify-labels.ts
-import json2md11 from "json2md";
-import { z as z15 } from "zod";
-var ModifyLabelsInputSchema = z15.object({
-  message_id: z15.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to modify labels for"),
-  add_labels: z15.array(z15.string()).optional().describe("Label IDs to add (e.g., ['STARRED', 'INBOX', 'UNREAD'] or custom label IDs)"),
-  remove_labels: z15.array(z15.string()).optional().describe("Label IDs to remove (e.g., ['UNREAD', 'INBOX'] to mark read and archive)"),
-  output_format: z15.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+import json2md12 from "json2md";
+import { z as z16 } from "zod";
+var ModifyLabelsInputSchema = z16.object({
+  message_id: z16.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to modify labels for"),
+  add_labels: z16.array(z16.string()).optional().describe("Label IDs to add (e.g., ['STARRED', 'INBOX', 'UNREAD'] or custom label IDs)"),
+  remove_labels: z16.array(z16.string()).optional().describe("Label IDs to remove (e.g., ['UNREAD', 'INBOX'] to mark read and archive)"),
+  output_format: z16.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function labelModificationToMarkdown(email, addedLabels, removedLabels) {
   const sections = [
@@ -2497,7 +2586,7 @@ function labelModificationToMarkdown(email, addedLabels, removedLabels) {
   sections.push({
     p: email.labels.length > 0 ? email.labels.join(", ") : "*No labels on this message*"
   });
-  return json2md11(sections);
+  return json2md12(sections);
 }
 async function modifyLabelsTool(gmailClient, params) {
   try {
@@ -2588,15 +2677,15 @@ This tool allows you to add or remove labels from a Gmail message. Labels are us
 - Move messages to trash or spam`;
 
 // src/tools/reply.ts
-import json2md12 from "json2md";
-import { z as z16 } from "zod";
-var ReplyInputSchema = z16.object({
-  message_id: z16.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to reply to"),
-  body: z16.string().min(1, "Reply body cannot be empty").describe("Reply message body"),
-  content_type: z16.enum(["text/plain", "text/html"]).default("text/plain").describe("Content type: text/plain (default) or text/html for HTML replies"),
-  cc: z16.email("CC must be a valid email address").optional().describe("CC (carbon copy) email address"),
-  confirm: z16.boolean().default(false).describe("Set to true to confirm and send the reply. If false, returns preview only."),
-  output_format: z16.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+import json2md13 from "json2md";
+import { z as z17 } from "zod";
+var ReplyInputSchema = z17.object({
+  message_id: z17.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to reply to"),
+  body: z17.string().min(1, "Reply body cannot be empty").describe("Reply message body"),
+  content_type: z17.enum(["text/plain", "text/html"]).default("text/plain").describe("Content type: text/plain (default) or text/html for HTML replies"),
+  cc: z17.email("CC must be a valid email address").optional().describe("CC (carbon copy) email address"),
+  confirm: z17.boolean().default(false).describe("Set to true to confirm and send the reply. If false, returns preview only."),
+  output_format: z17.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function replyPreviewToMarkdown(originalEmail, replyBody, contentType, cc) {
   const sections = [
@@ -2624,7 +2713,7 @@ function replyPreviewToMarkdown(originalEmail, replyBody, contentType, cc) {
     { h2: "Reply Body" },
     { p: replyBody }
   ];
-  return json2md12(sections);
+  return json2md13(sections);
 }
 function replySentToMarkdown(originalEmail, result, cc) {
   const sections = [
@@ -2643,7 +2732,7 @@ function replySentToMarkdown(originalEmail, result, cc) {
       p: "Your reply has been sent and added to the conversation thread."
     }
   ];
-  return json2md12(sections);
+  return json2md13(sections);
 }
 async function replyTool(gmailClient, params) {
   try {
@@ -2767,13 +2856,13 @@ This tool sends a reply to an existing email, automatically threading it in the
 4. Call with \`confirm: true\` to send`;
 
 // src/tools/search.ts
-import { z as z17 } from "zod";
-var SearchEmailsInputSchema = z17.object({
-  query: z17.string().min(1, "Query cannot be empty").describe('Gmail search query using Gmail search syntax (e.g., "from:user@example.com subject:test is:unread")'),
-  max_results: z17.number().int().min(1).max(100).default(10).describe("Maximum number of emails to return (default: 10, max: 100)"),
-  include_body: z17.boolean().default(false).describe("Whether to include full email body in results (default: false)"),
-  page_token: z17.string().optional().describe("Token for pagination to fetch next page of results"),
-  output_format: z17.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+import { z as z18 } from "zod";
+var SearchEmailsInputSchema = z18.object({
+  query: z18.string().min(1, "Query cannot be empty").describe('Gmail search query using Gmail search syntax (e.g., "from:user@example.com subject:test is:unread")'),
+  max_results: z18.number().int().min(1).max(100).default(10).describe("Maximum number of emails to return (default: 10, max: 100)"),
+  include_body: z18.boolean().default(false).describe("Whether to include full email body in results (default: false)"),
+  page_token: z18.string().optional().describe("Token for pagination to fetch next page of results"),
+  output_format: z18.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 async function searchEmailsTool(gmailClient, params) {
   try {
@@ -2843,17 +2932,17 @@ This tool allows you to search through your Gmail messages using the same query
 - Empty results if no emails match the query`;
 
 // src/tools/send-email.ts
-import json2md13 from "json2md";
-import { z as z18 } from "zod";
-var SendEmailInputSchema = z18.object({
-  to: z18.email("Must be a valid email address").describe("Recipient email address"),
-  subject: z18.string().min(1, "Subject cannot be empty").describe("Email subject"),
-  body: z18.string().min(1, "Body cannot be empty").describe("Email body content"),
-  content_type: z18.enum(["text/plain", "text/html"]).default("text/plain").describe("Content type: text/plain (default) or text/html for HTML emails"),
-  cc: z18.email("CC must be a valid email address").optional().describe("CC (carbon copy) email address"),
-  bcc: z18.email("BCC must be a valid email address").optional().describe("BCC (blind carbon copy) email address"),
-  confirm: z18.boolean().default(false).describe("Set to true to confirm and send the email. If false, returns preview only."),
-  output_format: z18.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+import json2md14 from "json2md";
+import { z as z19 } from "zod";
+var SendEmailInputSchema = z19.object({
+  to: z19.email("Must be a valid email address").describe("Recipient email address"),
+  subject: z19.string().min(1, "Subject cannot be empty").describe("Email subject"),
+  body: z19.string().min(1, "Body cannot be empty").describe("Email body content"),
+  content_type: z19.enum(["text/plain", "text/html"]).default("text/plain").describe("Content type: text/plain (default) or text/html for HTML emails"),
+  cc: z19.email("CC must be a valid email address").optional().describe("CC (carbon copy) email address"),
+  bcc: z19.email("BCC must be a valid email address").optional().describe("BCC (blind carbon copy) email address"),
+  confirm: z19.boolean().default(false).describe("Set to true to confirm and send the email. If false, returns preview only."),
+  output_format: z19.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function emailPreviewToMarkdown(params) {
   const sections = [
@@ -2874,7 +2963,7 @@ function emailPreviewToMarkdown(params) {
     { h2: "Body" },
     { p: params.body }
   ];
-  return json2md13(sections);
+  return json2md14(sections);
 }
 function emailSentToMarkdown(params, result) {
   const sections = [
@@ -2894,7 +2983,7 @@ function emailSentToMarkdown(params, result) {
       p: "The email has been sent and will appear in your Sent folder."
     }
   ];
-  return json2md13(sections);
+  return json2md14(sections);
 }
 async function sendEmailTool(gmailClient, params) {
   try {
@@ -3000,8 +3089,8 @@ This tool sends email through your Gmail account. It includes a safety feature:
 3. Call again with \`confirm: true\` to send`;
 
 // src/tools/update-label.ts
-import json2md14 from "json2md";
-import { z as z19 } from "zod";
+import json2md15 from "json2md";
+import { z as z20 } from "zod";
 var SYSTEM_LABELS2 = [
   "INBOX",
   "SENT",
@@ -3012,14 +3101,14 @@ var SYSTEM_LABELS2 = [
   "IMPORTANT",
   "UNREAD"
 ];
-var UpdateLabelInputSchema = z19.object({
-  label_id: z19.string().min(1, "Label ID cannot be empty").describe("The label ID to update (e.g., 'Label_123' or 'INBOX')"),
-  name: z19.string().optional().describe("New label name. Cannot rename system labels. Use '/' for nested labels."),
-  message_list_visibility: z19.enum(["show", "hide"]).optional().describe("How label appears in message list"),
-  label_list_visibility: z19.enum(["labelShow", "labelShowIfUnread", "labelHide"]).optional().describe("How label appears in label list (sidebar)"),
-  background_color: z19.string().optional().describe("Background color in hex format (e.g., '#ff0000'). Must provide both background and text color together."),
-  text_color: z19.string().optional().describe("Text color in hex format (e.g., '#ffffff'). Must provide both background and text color together."),
-  output_format: z19.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+var UpdateLabelInputSchema = z20.object({
+  label_id: z20.string().min(1, "Label ID cannot be empty").describe("The label ID to update (e.g., 'Label_123' or 'INBOX')"),
+  name: z20.string().optional().describe("New label name. Cannot rename system labels. Use '/' for nested labels."),
+  message_list_visibility: z20.enum(["show", "hide"]).optional().describe("How label appears in message list"),
+  label_list_visibility: z20.enum(["labelShow", "labelShowIfUnread", "labelHide"]).optional().describe("How label appears in label list (sidebar)"),
+  background_color: z20.string().optional().describe("Background color in hex format (e.g., '#ff0000'). Must provide both background and text color together."),
+  text_color: z20.string().optional().describe("Text color in hex format (e.g., '#ffffff'). Must provide both background and text color together."),
+  output_format: z20.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function updatedLabelToMarkdown(label, updates) {
   const sections = [
@@ -3067,7 +3156,7 @@ function updatedLabelToMarkdown(label, updates) {
       ]
     });
   }
-  return json2md14(sections);
+  return json2md15(sections);
 }
 async function updateLabelTool(gmailClient, params) {
   try {
@@ -3337,6 +3426,14 @@ async function startServer() {
       inputSchema: DeleteLabelInputSchema,
       annotations: DESTRUCTIVE_ANNOTATIONS,
       handler: deleteLabelTool
+    },
+    {
+      name: "gmcp_gmail_delete_email",
+      title: "Delete Gmail Email",
+      description: DELETE_EMAIL_DESCRIPTION,
+      inputSchema: DeleteEmailInputSchema,
+      annotations: DESTRUCTIVE_ANNOTATIONS,
+      handler: deleteEmailTool
     }
   ];
   const calendarTools = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gmcp",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "GMCP Server for Google Workspace with OAuth2 authentication",
   "module": "src/index.ts",
   "main": "dist/index.js",
@@ -44,22 +44,25 @@
     "anthropic"
   ],
   "dependencies": {
+    "@inquirer/prompts": "^8.2.0",
     "@modelcontextprotocol/sdk": "^1.25.3",
+    "@stricli/core": "^1.2.5",
     "googleapis": "^170.1.0",
     "json2md": "^2.0.3",
-    "pino": "^9.7.0",
-    "pino-pretty": "^13.0.0",
+    "kleur": "^4.1.5",
+    "pino": "^10.3.0",
+    "pino-pretty": "^13.1.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.3.12",
+    "@biomejs/biome": "2.3.13",
     "@changesets/changelog-github": "^0.5.2",
     "@changesets/cli": "^2.29.8",
     "@types/bun": "latest",
     "@types/json2md": "^1.5.4",
     "bunup": "^0.16.20",
-    "lefthook": "^2.0.15",
-    "ultracite": "7.0.12",
+    "lefthook": "^2.0.16",
+    "ultracite": "7.1.1",
     "vitest": "^4.0.18"
   },
   "peerDependencies": {