gmcp 0.4.0 → 0.5.0

package/README.md

@@ -148,7 +148,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 
 ## Tools
 
-### Gmail (16 tools)
+### Gmail (17 tools)
 
 | Tool | Description |
 |------|-------------|
@@ -161,6 +161,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 | `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_archive_email` | Archive email (remove from inbox) |
 | `gmcp_gmail_list_labels` | List all labels |
 | `gmcp_gmail_get_label` | Get label details |
 | `gmcp_gmail_create_label` | Create custom label |

package/dist/index.js

@@ -739,7 +739,7 @@ function registerTools(server, client, tools, logger) {
   }
 }
 
-// src/tools/batch-modify.ts
+// src/tools/archive-email.ts
 import json2md from "json2md";
 import { z } from "zod";
 
@@ -775,13 +775,108 @@ function createErrorResponse(context, error, logger) {
   };
 }
 
-// src/tools/batch-modify.ts
-var BatchModifyInputSchema = z.object({
-  message_ids: z.array(z.string()).min(1, "Must provide at least one message ID").max(1000, "Maximum 1000 messages per batch").describe("Array of Gmail message IDs to modify (max 1000)"),
-  add_labels: z.array(z.string()).optional().describe("Label IDs to add to all messages (e.g., ['STARRED', 'IMPORTANT'])"),
-  remove_labels: z.array(z.string()).optional().describe("Label IDs to remove from all messages (e.g., ['UNREAD', 'INBOX'])"),
+// src/tools/archive-email.ts
+var ArchiveEmailInputSchema = z.object({
+  message_id: z.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to archive"),
   output_format: z.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
+function archiveToMarkdown(email) {
+  const sections = [
+    { h1: "Email Archived Successfully" },
+    { h2: "Message Details" },
+    {
+      ul: [
+        `**Subject:** ${email.subject}`,
+        `**From:** ${email.from}`,
+        `**Message ID:** ${email.id}`
+      ]
+    },
+    { h2: "Current Labels" },
+    {
+      p: email.labels.length > 0 ? email.labels.join(", ") : "*No labels on this message*"
+    },
+    { h2: "Notes" },
+    {
+      ul: [
+        "The email has been removed from your inbox",
+        "The email is still accessible in All Mail",
+        "To unarchive, add the INBOX label back to the message"
+      ]
+    }
+  ];
+  return json2md(sections);
+}
+async function archiveEmailTool(gmailClient, params) {
+  try {
+    const email = await gmailClient.modifyLabels(params.message_id, undefined, [
+      "INBOX"
+    ]);
+    const formattedEmail = formatEmailForOutput(email);
+    const output = {
+      message_id: params.message_id,
+      subject: email.subject,
+      archived: true,
+      removed_labels: ["INBOX"],
+      current_labels: email.labels || []
+    };
+    const textContent = params.output_format === "json" ? JSON.stringify(output, null, 2) : archiveToMarkdown({
+      ...formattedEmail,
+      labels: email.labels || []
+    });
+    return {
+      content: [{ type: "text", text: textContent }],
+      structuredContent: output
+    };
+  } catch (error) {
+    return createErrorResponse("archiving email", error);
+  }
+}
+var ARCHIVE_EMAIL_DESCRIPTION = `Archive a Gmail email by removing it from the inbox.
+
+This tool archives an email message by removing the INBOX label. The email remains accessible in "All Mail" and can be unarchived by adding the INBOX label back.
+
+**Parameters**:
+- \`message_id\` (string, required): The Gmail message ID to archive
+- \`output_format\` (string, optional): Output format: "markdown" (default) or "json"
+
+**Returns**:
+- \`message_id\`: The archived message ID
+- \`subject\`: Email subject
+- \`archived\`: Always true on success
+- \`removed_labels\`: Labels that were removed (always ["INBOX"])
+- \`current_labels\`: All current labels on the message after archiving
+
+**Examples**:
+- Archive email: \`{ "message_id": "18f3c5d4e8a2b1c0" }\`
+- Archive with JSON output: \`{ "message_id": "18f3c5d4e8a2b1c0", "output_format": "json" }\`
+
+**Important Notes**:
+- This is a reversible operation - archived emails can be unarchived
+- The email is moved out of the inbox but remains in "All Mail"
+- To unarchive, use \`modify_labels\` with \`add_labels: ["INBOX"]\`
+- This is different from \`delete_email\` which permanently removes the message
+
+**Use Cases**:
+- Clean up inbox without deleting emails
+- Archive emails after reading/processing them
+- Remove emails from inbox while keeping them for reference
+
+**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/batch-modify.ts
+import json2md2 from "json2md";
+import { z as z2 } from "zod";
+var BatchModifyInputSchema = z2.object({
+  message_ids: z2.array(z2.string()).min(1, "Must provide at least one message ID").max(1000, "Maximum 1000 messages per batch").describe("Array of Gmail message IDs to modify (max 1000)"),
+  add_labels: z2.array(z2.string()).optional().describe("Label IDs to add to all messages (e.g., ['STARRED', 'IMPORTANT'])"),
+  remove_labels: z2.array(z2.string()).optional().describe("Label IDs to remove from all messages (e.g., ['UNREAD', 'INBOX'])"),
+  output_format: z2.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+});
 function batchModificationToMarkdown(messageCount, addedLabels, removedLabels) {
   const sections = [
     { h1: "Batch Label Modification Successful" },
@@ -798,7 +893,7 @@ function batchModificationToMarkdown(messageCount, addedLabels, removedLabels) {
   sections.push({
     p: `All ${messageCount} messages have been updated successfully.`
   });
-  return json2md(sections);
+  return json2md2(sections);
 }
 async function batchModifyTool(gmailClient, params) {
   try {
@@ -890,10 +985,10 @@ This tool allows you to efficiently add or remove labels from multiple Gmail mes
 - Recommended for operations affecting more than 5 messages`;
 
 // src/tools/calendar-create.ts
-import { z as z2 } from "zod";
+import { z as z3 } from "zod";
 
 // src/utils/markdown.ts
-import json2md2 from "json2md";
+import json2md3 from "json2md";
 function emailToJson2md(email) {
   const elements = [
     { h2: email.subject },
@@ -935,7 +1030,7 @@ function searchResultsToMarkdown(query, data) {
       });
     }
   }
-  return json2md2(elements);
+  return json2md3(elements);
 }
 function calendarListToMarkdown(data) {
   const sections = [
@@ -961,7 +1056,7 @@ function calendarListToMarkdown(data) {
       sections.push({ ul: details });
     }
   }
-  return json2md2(sections);
+  return json2md3(sections);
 }
 function formatEventTime(time) {
   if (time.date) {
@@ -1028,7 +1123,7 @@ function eventListToMarkdown(data) {
       sections.push({ hr: "" });
     }
   }
-  return json2md2(sections);
+  return json2md3(sections);
 }
 function formatAttendeeDetailed(att) {
   const name = att.display_name || att.email;
@@ -1076,23 +1171,23 @@ function eventToMarkdown(event, successMessage) {
     sections.push({ ul: event.attendees.map(formatAttendeeDetailed) });
   }
   addEventMetadata(sections, event);
-  return json2md2(sections);
+  return json2md3(sections);
 }
 
 // src/tools/calendar-create.ts
-var CalendarCreateEventInputSchema = z2.object({
-  calendar_id: z2.string().default("primary").describe('Calendar ID to create event in (default: "primary")'),
-  summary: z2.string().min(1, "Event title is required").describe("Event title/summary (required)"),
-  start: z2.string().min(1, "Start time is required").describe('Start time: RFC3339 (e.g., "2024-01-15T09:00:00-08:00") or date for all-day (e.g., "2024-01-15")'),
-  end: z2.string().min(1, "End time is required").describe('End time: RFC3339 (e.g., "2024-01-15T10:00:00-08:00") or date for all-day (e.g., "2024-01-15")'),
-  description: z2.string().optional().describe("Event description (optional)"),
-  location: z2.string().optional().describe("Event location (optional)"),
-  attendees: z2.array(z2.string().email()).optional().describe("Array of attendee email addresses (optional)"),
-  timezone: z2.string().optional().describe('IANA timezone (e.g., "America/Los_Angeles", optional)'),
-  recurrence: z2.array(z2.string()).optional().describe('Recurrence rules as RRULE strings (e.g., ["RRULE:FREQ=WEEKLY;COUNT=10"], optional)'),
-  add_meet: z2.boolean().default(false).describe("Auto-create Google Meet conference link (default: false)"),
-  confirm: z2.boolean().default(false).describe("Must be true to create the event (safety check)"),
-  output_format: z2.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+var CalendarCreateEventInputSchema = z3.object({
+  calendar_id: z3.string().default("primary").describe('Calendar ID to create event in (default: "primary")'),
+  summary: z3.string().min(1, "Event title is required").describe("Event title/summary (required)"),
+  start: z3.string().min(1, "Start time is required").describe('Start time: RFC3339 (e.g., "2024-01-15T09:00:00-08:00") or date for all-day (e.g., "2024-01-15")'),
+  end: z3.string().min(1, "End time is required").describe('End time: RFC3339 (e.g., "2024-01-15T10:00:00-08:00") or date for all-day (e.g., "2024-01-15")'),
+  description: z3.string().optional().describe("Event description (optional)"),
+  location: z3.string().optional().describe("Event location (optional)"),
+  attendees: z3.array(z3.string().email()).optional().describe("Array of attendee email addresses (optional)"),
+  timezone: z3.string().optional().describe('IANA timezone (e.g., "America/Los_Angeles", optional)'),
+  recurrence: z3.array(z3.string()).optional().describe('Recurrence rules as RRULE strings (e.g., ["RRULE:FREQ=WEEKLY;COUNT=10"], optional)'),
+  add_meet: z3.boolean().default(false).describe("Auto-create Google Meet conference link (default: false)"),
+  confirm: z3.boolean().default(false).describe("Must be true to create the event (safety check)"),
+  output_format: z3.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 async function calendarCreateEventTool(calendarClient, params) {
   if (!params.confirm) {
@@ -1243,16 +1338,16 @@ Created event object containing:
 - Returns error if Calendar API request fails`;
 
 // src/tools/calendar-events.ts
-import { z as z3 } from "zod";
-var CalendarEventsInputSchema = z3.object({
-  calendar_id: z3.string().default("primary").describe('Calendar ID to list events from (default: "primary")'),
-  time_min: z3.string().optional().describe("Lower bound for event start time (RFC3339, e.g., 2024-01-01T00:00:00Z)"),
-  time_max: z3.string().optional().describe("Upper bound for event start time (RFC3339, e.g., 2024-12-31T23:59:59Z)"),
-  max_results: z3.number().int().min(1).max(250).default(10).describe("Maximum number of events to return (default: 10, max: 250)"),
-  query: z3.string().optional().describe("Free text search query to filter events"),
-  single_events: z3.boolean().default(true).describe("Expand recurring events into individual instances (default: true)"),
-  order_by: z3.enum(["startTime", "updated"]).default("startTime").describe('Sort order: "startTime" (default) or "updated"'),
-  output_format: z3.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+import { z as z4 } from "zod";
+var CalendarEventsInputSchema = z4.object({
+  calendar_id: z4.string().default("primary").describe('Calendar ID to list events from (default: "primary")'),
+  time_min: z4.string().optional().describe("Lower bound for event start time (RFC3339, e.g., 2024-01-01T00:00:00Z)"),
+  time_max: z4.string().optional().describe("Upper bound for event start time (RFC3339, e.g., 2024-12-31T23:59:59Z)"),
+  max_results: z4.number().int().min(1).max(250).default(10).describe("Maximum number of events to return (default: 10, max: 250)"),
+  query: z4.string().optional().describe("Free text search query to filter events"),
+  single_events: z4.boolean().default(true).describe("Expand recurring events into individual instances (default: true)"),
+  order_by: z4.enum(["startTime", "updated"]).default("startTime").describe('Sort order: "startTime" (default) or "updated"'),
+  output_format: z4.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 async function calendarEventsTool(calendarClient, params) {
   try {
@@ -1350,11 +1445,11 @@ This tool retrieves events from a specified calendar with support for time range
 - Returns empty array if no events match filters`;
 
 // src/tools/calendar-get-event.ts
-import { z as z4 } from "zod";
-var CalendarGetEventInputSchema = z4.object({
-  calendar_id: z4.string().default("primary").describe('Calendar ID (default: "primary")'),
-  event_id: z4.string().min(1, "Event ID is required").describe("Event ID to retrieve"),
-  output_format: z4.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+import { z as z5 } from "zod";
+var CalendarGetEventInputSchema = z5.object({
+  calendar_id: z5.string().default("primary").describe('Calendar ID (default: "primary")'),
+  event_id: z5.string().min(1, "Event ID is required").describe("Event ID to retrieve"),
+  output_format: z5.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 async function calendarGetEventTool(calendarClient, params) {
   try {
@@ -1446,10 +1541,10 @@ Complete event object containing:
 - Returns error if Calendar API request fails`;
 
 // src/tools/calendar-list.ts
-import { z as z5 } from "zod";
-var CalendarListInputSchema = z5.object({
-  show_hidden: z5.boolean().default(false).describe("Include hidden calendars in the results (default: false)"),
-  output_format: z5.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+import { z as z6 } from "zod";
+var CalendarListInputSchema = z6.object({
+  show_hidden: z6.boolean().default(false).describe("Include hidden calendars in the results (default: false)"),
+  output_format: z6.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 async function calendarListTool(calendarClient, params) {
   try {
@@ -1511,16 +1606,16 @@ This tool retrieves all calendars accessible by the authenticated user, includin
 - Returns error if Calendar API request fails`;
 
 // src/tools/create-draft.ts
-import json2md3 from "json2md";
-import { z as z6 } from "zod";
-var CreateDraftInputSchema = z6.object({
-  to: z6.email("Must be a valid email address").describe("Recipient email address"),
-  subject: z6.string().min(1, "Subject cannot be empty").describe("Email subject"),
-  body: z6.string().min(1, "Body cannot be empty").describe("Email body content"),
-  content_type: z6.enum(["text/plain", "text/html"]).default("text/plain").describe("Content type: text/plain (default) or text/html for HTML emails"),
-  cc: z6.email("CC must be a valid email address").optional().describe("CC (carbon copy) email address"),
-  bcc: z6.email("BCC must be a valid email address").optional().describe("BCC (blind carbon copy) email address"),
-  output_format: z6.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+import json2md4 from "json2md";
+import { z as z7 } from "zod";
+var CreateDraftInputSchema = z7.object({
+  to: z7.email("Must be a valid email address").describe("Recipient email address"),
+  subject: z7.string().min(1, "Subject cannot be empty").describe("Email subject"),
+  body: z7.string().min(1, "Body cannot be empty").describe("Email body content"),
+  content_type: z7.enum(["text/plain", "text/html"]).default("text/plain").describe("Content type: text/plain (default) or text/html for HTML emails"),
+  cc: z7.email("CC must be a valid email address").optional().describe("CC (carbon copy) email address"),
+  bcc: z7.email("BCC must be a valid email address").optional().describe("BCC (blind carbon copy) email address"),
+  output_format: z7.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function draftCreatedToMarkdown(params, result) {
   const sections = [
@@ -1540,7 +1635,7 @@ function draftCreatedToMarkdown(params, result) {
       p: "The draft has been saved and will appear in your Drafts folder. You can edit and send it later from Gmail."
     }
   ];
-  return json2md3(sections);
+  return json2md4(sections);
 }
 async function createDraftTool(gmailClient, params) {
   try {
@@ -1634,15 +1729,15 @@ This tool creates a draft email in your Gmail Drafts folder. Unlike sending an e
 - Collaborative: Others with access can review drafts`;
 
 // src/tools/create-label.ts
-import json2md4 from "json2md";
-import { z as z7 } from "zod";
-var CreateLabelInputSchema = z7.object({
-  name: z7.string().min(1, "Label name cannot be empty").describe("The label name (e.g., 'Work', 'Personal/Family'). Use '/' for nested labels."),
-  message_list_visibility: z7.enum(["show", "hide"]).optional().describe("How label appears in message list. Default: 'show'. Use 'hide' to hide messages with this label from message list."),
-  label_list_visibility: z7.enum(["labelShow", "labelShowIfUnread", "labelHide"]).optional().describe("How label appears in label list. Default: 'labelShow'. Options: 'labelShow' (always visible), 'labelShowIfUnread' (only when unread), 'labelHide' (hidden)."),
-  background_color: z7.string().optional().describe("Background color in hex format (e.g., '#ff0000'). Must provide both background and text color together."),
-  text_color: z7.string().optional().describe("Text color in hex format (e.g., '#ffffff'). Must provide both background and text color together."),
-  output_format: z7.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
+import json2md5 from "json2md";
+import { z as z8 } from "zod";
+var CreateLabelInputSchema = z8.object({
+  name: z8.string().min(1, "Label name cannot be empty").describe("The label name (e.g., 'Work', 'Personal/Family'). Use '/' for nested labels."),
+  message_list_visibility: z8.enum(["show", "hide"]).optional().describe("How label appears in message list. Default: 'show'. Use 'hide' to hide messages with this label from message list."),
+  label_list_visibility: z8.enum(["labelShow", "labelShowIfUnread", "labelHide"]).optional().describe("How label appears in label list. Default: 'labelShow'. Options: 'labelShow' (always visible), 'labelShowIfUnread' (only when unread), 'labelHide' (hidden)."),
+  background_color: z8.string().optional().describe("Background color in hex format (e.g., '#ff0000'). Must provide both background and text color together."),
+  text_color: z8.string().optional().describe("Text color in hex format (e.g., '#ffffff'). Must provide both background and text color together."),
+  output_format: z8.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function createdLabelToMarkdown(label) {
   const sections = [
@@ -1679,7 +1774,7 @@ function createdLabelToMarkdown(label) {
   sections.push({
     p: `You can now use this label ID (${label.id}) with other tools like modify_labels or batch_modify.`
   });
-  return json2md4(sections);
+  return json2md5(sections);
 }
 async function createLabelTool(gmailClient, params) {
   try {
@@ -1771,11 +1866,11 @@ This tool creates a new label with customizable visibility and color settings. L
 - Requires \`gmail.labels\` or \`gmail.modify\` scope`;
 
 // 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")
+import json2md6 from "json2md";
+import { z as z9 } from "zod";
+var DeleteEmailInputSchema = z9.object({
+  message_id: z9.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to permanently delete"),
+  output_format: z9.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function deletionToMarkdown(messageId) {
   const sections = [
@@ -1792,7 +1887,7 @@ function deletionToMarkdown(messageId) {
       ]
     }
   ];
-  return json2md5(sections);
+  return json2md6(sections);
 }
 async function deleteEmailTool(gmailClient, params) {
   try {
@@ -1850,8 +1945,8 @@ This tool permanently deletes an email message from your Gmail account. Unlike m
 - Requires \`gmail.modify\` or full \`mail.google.com\` scope`;
 
 // src/tools/delete-label.ts
-import json2md6 from "json2md";
-import { z as z9 } from "zod";
+import json2md7 from "json2md";
+import { z as z10 } from "zod";
 var SYSTEM_LABELS = [
   "INBOX",
   "SENT",
@@ -1867,9 +1962,9 @@ var SYSTEM_LABELS = [
   "CATEGORY_UPDATES",
   "CATEGORY_FORUMS"
 ];
-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")
+var DeleteLabelInputSchema = z10.object({
+  label_id: z10.string().min(1, "Label ID cannot be empty").describe("The label ID to delete (e.g., 'Label_123'). Cannot delete system labels."),
+  output_format: z10.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function deletionToMarkdown2(labelId) {
   const sections = [
@@ -1887,7 +1982,7 @@ function deletionToMarkdown2(labelId) {
       ]
     }
   ];
-  return json2md6(sections);
+  return json2md7(sections);
 }
 async function deleteLabelTool(gmailClient, params) {
   try {
@@ -2009,11 +2104,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 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)")
+import { z as z11 } from "zod";
+var GetAttachmentInputSchema = z11.object({
+  message_id: z11.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID containing the attachment"),
+  attachment_id: z11.string().min(1, "Attachment ID cannot be empty").describe("The attachment ID to download (from list_attachments)"),
+  output_format: z11.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 {
@@ -2080,12 +2175,12 @@ To decode:
 3. Decode base64url data to get original file content`;
 
 // src/tools/get-email.ts
-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")
+import json2md8 from "json2md";
+import { z as z12 } from "zod";
+var GetEmailInputSchema = z12.object({
+  message_id: z12.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to retrieve"),
+  include_body: z12.boolean().default(true).describe("Whether to include full email body in results (default: true)"),
+  output_format: z12.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function emailToMarkdown(email) {
   const sections = [
@@ -2112,7 +2207,7 @@ function emailToMarkdown(email) {
     sections.push({ h2: "Snippet" });
     sections.push({ p: email.snippet });
   }
-  return json2md7(sections);
+  return json2md8(sections);
 }
 async function getEmailTool(gmailClient, params) {
   try {
@@ -2163,11 +2258,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 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")
+import json2md9 from "json2md";
+import { z as z13 } from "zod";
+var GetLabelInputSchema = z13.object({
+  label_id: z13.string().min(1, "Label ID cannot be empty").describe("The label ID to retrieve (e.g., 'INBOX', 'Label_123')"),
+  output_format: z13.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function labelToMarkdown(label) {
   const sections = [
@@ -2202,7 +2297,7 @@ function labelToMarkdown(label) {
       ]
     });
   }
-  return json2md8(sections);
+  return json2md9(sections);
 }
 async function getLabelTool(gmailClient, params) {
   try {
@@ -2269,12 +2364,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 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")
+import json2md10 from "json2md";
+import { z as z14 } from "zod";
+var GetThreadInputSchema = z14.object({
+  thread_id: z14.string().min(1, "Thread ID cannot be empty").describe("The Gmail thread ID to retrieve"),
+  include_body: z14.boolean().default(false).describe("Whether to include full email body for all messages (default: false)"),
+  output_format: z14.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function threadToMarkdown(threadId, messages) {
   const sections = [
@@ -2309,7 +2404,7 @@ function threadToMarkdown(threadId, messages) {
       sections.push({ p: "---" });
     }
   }
-  return json2md9(sections);
+  return json2md10(sections);
 }
 async function getThreadTool(gmailClient, params) {
   try {
@@ -2367,11 +2462,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 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")
+import json2md11 from "json2md";
+import { z as z15 } from "zod";
+var ListAttachmentsInputSchema = z15.object({
+  message_id: z15.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to list attachments from"),
+  output_format: z15.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function formatBytes(bytes) {
   if (bytes === 0) {
@@ -2403,7 +2498,7 @@ function attachmentsToMarkdown(messageId, attachments) {
       });
     }
   }
-  return json2md10(sections);
+  return json2md11(sections);
 }
 async function listAttachmentsTool(gmailClient, params) {
   try {
@@ -2461,10 +2556,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 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")
+import json2md12 from "json2md";
+import { z as z16 } from "zod";
+var ListLabelsInputSchema = z16.object({
+  output_format: z16.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function labelsToMarkdown(labels) {
   const sections = [{ h1: "Gmail Labels" }];
@@ -2481,7 +2576,7 @@ function labelsToMarkdown(labels) {
   if (labels.system.length === 0 && labels.user.length === 0) {
     sections.push({ p: "*No labels found*" });
   }
-  return json2md11(sections);
+  return json2md12(sections);
 }
 async function listLabelsTool(gmailClient, params) {
   try {
@@ -2554,13 +2649,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 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")
+import json2md13 from "json2md";
+import { z as z17 } from "zod";
+var ModifyLabelsInputSchema = z17.object({
+  message_id: z17.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to modify labels for"),
+  add_labels: z17.array(z17.string()).optional().describe("Label IDs to add (e.g., ['STARRED', 'INBOX', 'UNREAD'] or custom label IDs)"),
+  remove_labels: z17.array(z17.string()).optional().describe("Label IDs to remove (e.g., ['UNREAD', 'INBOX'] to mark read and archive)"),
+  output_format: z17.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function labelModificationToMarkdown(email, addedLabels, removedLabels) {
   const sections = [
@@ -2586,7 +2681,7 @@ function labelModificationToMarkdown(email, addedLabels, removedLabels) {
   sections.push({
     p: email.labels.length > 0 ? email.labels.join(", ") : "*No labels on this message*"
   });
-  return json2md12(sections);
+  return json2md13(sections);
 }
 async function modifyLabelsTool(gmailClient, params) {
   try {
@@ -2677,15 +2772,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 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")
+import json2md14 from "json2md";
+import { z as z18 } from "zod";
+var ReplyInputSchema = z18.object({
+  message_id: z18.string().min(1, "Message ID cannot be empty").describe("The Gmail message ID to reply to"),
+  body: z18.string().min(1, "Reply body cannot be empty").describe("Reply message body"),
+  content_type: z18.enum(["text/plain", "text/html"]).default("text/plain").describe("Content type: text/plain (default) or text/html for HTML replies"),
+  cc: z18.email("CC must be a valid email address").optional().describe("CC (carbon copy) email address"),
+  confirm: z18.boolean().default(false).describe("Set to true to confirm and send the reply. If false, returns preview only."),
+  output_format: z18.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function replyPreviewToMarkdown(originalEmail, replyBody, contentType, cc) {
   const sections = [
@@ -2713,7 +2808,7 @@ function replyPreviewToMarkdown(originalEmail, replyBody, contentType, cc) {
     { h2: "Reply Body" },
     { p: replyBody }
   ];
-  return json2md13(sections);
+  return json2md14(sections);
 }
 function replySentToMarkdown(originalEmail, result, cc) {
   const sections = [
@@ -2732,7 +2827,7 @@ function replySentToMarkdown(originalEmail, result, cc) {
       p: "Your reply has been sent and added to the conversation thread."
     }
   ];
-  return json2md13(sections);
+  return json2md14(sections);
 }
 async function replyTool(gmailClient, params) {
   try {
@@ -2856,13 +2951,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 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")
+import { z as z19 } from "zod";
+var SearchEmailsInputSchema = z19.object({
+  query: z19.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: z19.number().int().min(1).max(100).default(10).describe("Maximum number of emails to return (default: 10, max: 100)"),
+  include_body: z19.boolean().default(false).describe("Whether to include full email body in results (default: false)"),
+  page_token: z19.string().optional().describe("Token for pagination to fetch next page of results"),
+  output_format: z19.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 async function searchEmailsTool(gmailClient, params) {
   try {
@@ -2932,17 +3027,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 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")
+import json2md15 from "json2md";
+import { z as z20 } from "zod";
+var SendEmailInputSchema = z20.object({
+  to: z20.email("Must be a valid email address").describe("Recipient email address"),
+  subject: z20.string().min(1, "Subject cannot be empty").describe("Email subject"),
+  body: z20.string().min(1, "Body cannot be empty").describe("Email body content"),
+  content_type: z20.enum(["text/plain", "text/html"]).default("text/plain").describe("Content type: text/plain (default) or text/html for HTML emails"),
+  cc: z20.email("CC must be a valid email address").optional().describe("CC (carbon copy) email address"),
+  bcc: z20.email("BCC must be a valid email address").optional().describe("BCC (blind carbon copy) email address"),
+  confirm: z20.boolean().default(false).describe("Set to true to confirm and send the email. If false, returns preview only."),
+  output_format: z20.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function emailPreviewToMarkdown(params) {
   const sections = [
@@ -2963,7 +3058,7 @@ function emailPreviewToMarkdown(params) {
     { h2: "Body" },
     { p: params.body }
   ];
-  return json2md14(sections);
+  return json2md15(sections);
 }
 function emailSentToMarkdown(params, result) {
   const sections = [
@@ -2983,7 +3078,7 @@ function emailSentToMarkdown(params, result) {
       p: "The email has been sent and will appear in your Sent folder."
     }
   ];
-  return json2md14(sections);
+  return json2md15(sections);
 }
 async function sendEmailTool(gmailClient, params) {
   try {
@@ -3089,8 +3184,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 json2md15 from "json2md";
-import { z as z20 } from "zod";
+import json2md16 from "json2md";
+import { z as z21 } from "zod";
 var SYSTEM_LABELS2 = [
   "INBOX",
   "SENT",
@@ -3101,14 +3196,14 @@ var SYSTEM_LABELS2 = [
   "IMPORTANT",
   "UNREAD"
 ];
-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")
+var UpdateLabelInputSchema = z21.object({
+  label_id: z21.string().min(1, "Label ID cannot be empty").describe("The label ID to update (e.g., 'Label_123' or 'INBOX')"),
+  name: z21.string().optional().describe("New label name. Cannot rename system labels. Use '/' for nested labels."),
+  message_list_visibility: z21.enum(["show", "hide"]).optional().describe("How label appears in message list"),
+  label_list_visibility: z21.enum(["labelShow", "labelShowIfUnread", "labelHide"]).optional().describe("How label appears in label list (sidebar)"),
+  background_color: z21.string().optional().describe("Background color in hex format (e.g., '#ff0000'). Must provide both background and text color together."),
+  text_color: z21.string().optional().describe("Text color in hex format (e.g., '#ffffff'). Must provide both background and text color together."),
+  output_format: z21.enum(["markdown", "json"]).default("markdown").describe("Output format: markdown (default) or json")
 });
 function updatedLabelToMarkdown(label, updates) {
   const sections = [
@@ -3156,7 +3251,7 @@ function updatedLabelToMarkdown(label, updates) {
       ]
     });
   }
-  return json2md15(sections);
+  return json2md16(sections);
 }
 async function updateLabelTool(gmailClient, params) {
   try {
@@ -3434,6 +3529,14 @@ async function startServer() {
       inputSchema: DeleteEmailInputSchema,
       annotations: DESTRUCTIVE_ANNOTATIONS,
       handler: deleteEmailTool
+    },
+    {
+      name: "gmcp_gmail_archive_email",
+      title: "Archive Gmail Email",
+      description: ARCHIVE_EMAIL_DESCRIPTION,
+      inputSchema: ArchiveEmailInputSchema,
+      annotations: MODIFY_ANNOTATIONS,
+      handler: archiveEmailTool
     }
   ];
   const calendarTools = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gmcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "GMCP Server for Google Workspace with OAuth2 authentication",
   "module": "src/index.ts",
   "main": "dist/index.js",