@dguido/google-workspace-mcp 1.0.0 → 1.1.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Dan Guido
+Copyright (c) 2026 Dan Guido
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -95,6 +95,28 @@ Create a presentation called "Product Roadmap" with slides for Q1 milestones.
 
 Tokens are stored at `~/.config/google-workspace-mcp/tokens.json` by default.
 
+### Token-Efficient Output (TOON)
+
+For LLM-optimized responses that reduce token usage by 20-50%, enable TOON format:
+
+```json
+{
+  "mcpServers": {
+    "google-workspace": {
+      "command": "npx",
+      "args": ["@dguido/google-workspace-mcp"],
+      "env": {
+        "GOOGLE_DRIVE_OAUTH_CREDENTIALS": "/path/to/gcp-oauth.keys.json",
+        "GOOGLE_WORKSPACE_SERVICES": "drive,gmail,calendar",
+        "GOOGLE_WORKSPACE_TOON_FORMAT": "true"
+      }
+    }
+  }
+}
+```
+
+TOON (Token-Oriented Object Notation) encodes structured responses more compactly than JSON by eliminating repeated field names. Savings are highest for list operations (calendars, events, emails, filters).
+
 ### Service Configuration
 
 By default, we recommend enabling only the core services (`drive,gmail,calendar`) as shown in Quick Start. This provides file management, email, and calendar capabilities without the complexity of document editing tools.
@@ -125,25 +147,33 @@ See [Advanced Configuration](docs/ADVANCED.md) for multi-account setup and envir
 
 ## Available Tools
 
-### Drive Operations
+### Drive (29 tools)
+
+`search` `listFolder` `createFolder` `createTextFile` `updateTextFile` `deleteItem` `renameItem` `moveItem` `copyFile` `getFileMetadata` `exportFile` `shareFile` `getSharing` `removePermission` `listRevisions` `restoreRevision` `downloadFile` `uploadFile` `getStorageQuota` `starFile` `resolveFilePath` `batchDelete` `batchRestore` `batchMove` `batchShare` `listTrash` `restoreFromTrash` `emptyTrash` `getFolderTree`
 
-`search` `listFolder` `createFolder` `deleteItem` `renameItem` `moveItem` `copyFile`
+### Google Docs (8 tools)
 
-### File Operations
+`createGoogleDoc` `updateGoogleDoc` `getGoogleDocContent` `appendToDoc` `insertTextInDoc` `deleteTextInDoc` `replaceTextInDoc` `formatGoogleDocRange`
 
-`createTextFile` `updateTextFile`
+### Google Sheets (7 tools)
 
-### Google Docs
+`createGoogleSheet` `updateGoogleSheet` `getGoogleSheetContent` `formatGoogleSheetCells` `mergeGoogleSheetCells` `addGoogleSheetConditionalFormat` `sheetTabs`
 
-`createGoogleDoc` `updateGoogleDoc` `getGoogleDocContent` `formatGoogleDocRange`
+### Google Slides (10 tools)
 
-### Google Sheets
+`createGoogleSlides` `updateGoogleSlides` `getGoogleSlidesContent` `formatSlidesText` `formatSlidesShape` `formatSlideBackground` `createGoogleSlidesTextBox` `createGoogleSlidesShape` `slidesSpeakerNotes` `listSlidePages`
 
-`createGoogleSheet` `updateGoogleSheet` `getGoogleSheetContent` `formatGoogleSheetCells` `formatGoogleSheetText` `formatGoogleSheetNumbers` `setGoogleSheetBorders` `mergeGoogleSheetCells` `addGoogleSheetConditionalFormat`
+### Calendar (7 tools)
 
-### Google Slides
+`listCalendars` `listEvents` `getEvent` `createEvent` `updateEvent` `deleteEvent` `findFreeTime`
 
-`createGoogleSlides` `updateGoogleSlides` `getGoogleSlidesContent` `formatGoogleSlidesElement` `createGoogleSlidesTextBox` `createGoogleSlidesShape` `getGoogleSlidesSpeakerNotes` `updateGoogleSlidesSpeakerNotes`
+### Gmail (14 tools)
+
+`sendEmail` `draftEmail` `readEmail` `searchEmails` `deleteEmail` `modifyEmail` `downloadAttachment` `listLabels` `getOrCreateLabel` `updateLabel` `deleteLabel` `createFilter` `listFilters` `deleteFilter`
+
+### Unified (3 tools)
+
+`createFile` `updateFile` `getFileContent`
 
 [Full API Reference](docs/API.md)
 
@@ -194,10 +224,6 @@ npm test         # Run tests
 
 See [Contributing Guide](CONTRIBUTING.md) for project structure and development workflow.
 
-## Docker
-
-See [Docker Usage](docs/DOCKER.md) for containerized deployment.
-
 ## Links
 
 - [GitHub Repository](https://github.com/dguido/google-workspace-mcp)

package/dist/index.js

@@ -21,6 +21,56 @@ var init_logging = __esm({
   }
 });
 
+// src/config/services.ts
+function getEnabledServices() {
+  if (enabledServices !== null) return enabledServices;
+  const envValue = process.env.GOOGLE_WORKSPACE_SERVICES;
+  if (envValue === void 0) {
+    enabledServices = new Set(SERVICE_NAMES);
+    return enabledServices;
+  }
+  if (envValue.trim() === "") {
+    enabledServices = /* @__PURE__ */ new Set();
+    return enabledServices;
+  }
+  const requested = envValue.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
+  const valid = /* @__PURE__ */ new Set();
+  const unknown = [];
+  for (const service of requested) {
+    if (SERVICE_NAMES.includes(service)) {
+      valid.add(service);
+    } else {
+      unknown.push(service);
+    }
+  }
+  if (unknown.length > 0) {
+    console.warn(
+      `[google-workspace-mcp] Unknown services: ${unknown.join(", ")}. Valid: ${SERVICE_NAMES.join(", ")}`
+    );
+  }
+  enabledServices = valid;
+  return enabledServices;
+}
+function isServiceEnabled(service) {
+  return getEnabledServices().has(service);
+}
+function areUnifiedToolsEnabled() {
+  const enabled = getEnabledServices();
+  return UNIFIED_REQUIRED_SERVICES.every((s) => enabled.has(s));
+}
+function isToonEnabled() {
+  return process.env.GOOGLE_WORKSPACE_TOON_FORMAT === "true";
+}
+var SERVICE_NAMES, UNIFIED_REQUIRED_SERVICES, enabledServices;
+var init_services = __esm({
+  "src/config/services.ts"() {
+    "use strict";
+    SERVICE_NAMES = ["drive", "docs", "sheets", "slides", "calendar", "gmail"];
+    UNIFIED_REQUIRED_SERVICES = ["drive", "docs", "sheets", "slides"];
+    enabledServices = null;
+  }
+});
+
 // src/utils/responses.ts
 function truncateResponse(content) {
   if (content.length <= CHARACTER_LIMIT) {
@@ -38,11 +88,14 @@ function successResponse(text) {
   return { content: [{ type: "text", text }], isError: false };
 }
 function structuredResponse(text, data) {
-  return {
+  const response = {
     content: [{ type: "text", text }],
-    structuredContent: data,
     isError: false
   };
+  if (!isToonEnabled()) {
+    response.structuredContent = data;
+  }
+  return response;
 }
 function errorResponse(message, options) {
   log("Error", { message, ...options });
@@ -62,6 +115,7 @@ var CHARACTER_LIMIT;
 var init_responses = __esm({
   "src/utils/responses.ts"() {
     "use strict";
+    init_services();
     init_logging();
     CHARACTER_LIMIT = 25e3;
   }
@@ -137,7 +191,7 @@ function getGmailService(authClient2) {
   return gmailService;
 }
 var docsService, sheetsService, slidesService, calendarService, gmailService, lastAuthClient;
-var init_services = __esm({
+var init_services2 = __esm({
   "src/utils/services.ts"() {
     "use strict";
     docsService = null;
@@ -776,6 +830,25 @@ var init_mime = __esm({
   }
 });
 
+// src/utils/toon.ts
+import { encode } from "@toon-format/toon";
+function toToon(data) {
+  if (!isToonEnabled()) {
+    return JSON.stringify(data, null, 2);
+  }
+  try {
+    return encode(data);
+  } catch {
+    return JSON.stringify(data, null, 2);
+  }
+}
+var init_toon = __esm({
+  "src/utils/toon.ts"() {
+    "use strict";
+    init_services();
+  }
+});
+
 // src/utils/index.ts
 var utils_exports = {};
 __export(utils_exports, {
@@ -807,6 +880,7 @@ __export(utils_exports, {
   structuredResponse: () => structuredResponse,
   successResponse: () => successResponse,
   supportsFormElicitation: () => supportsFormElicitation,
+  toToon: () => toToon,
   truncateResponse: () => truncateResponse,
   validateArgs: () => validateArgs,
   withProgressReporting: () => withProgressReporting,
@@ -820,13 +894,14 @@ var init_utils = __esm({
     init_logging();
     init_responses();
     init_validation();
-    init_services();
+    init_services2();
     init_timeout();
     init_retry();
     init_elicitation();
     init_progress();
     init_pathCache();
     init_mime();
+    init_toon();
   }
 });
 
@@ -1458,46 +1533,8 @@ import { fileURLToPath as fileURLToPath2 } from "url";
 import { readFileSync } from "fs";
 import { join as join3, dirname as dirname3 } from "path";
 
-// src/config/services.ts
-var SERVICE_NAMES = ["drive", "docs", "sheets", "slides", "calendar", "gmail"];
-var UNIFIED_REQUIRED_SERVICES = ["drive", "docs", "sheets", "slides"];
-var enabledServices = null;
-function getEnabledServices() {
-  if (enabledServices !== null) return enabledServices;
-  const envValue = process.env.GOOGLE_WORKSPACE_SERVICES;
-  if (envValue === void 0) {
-    enabledServices = new Set(SERVICE_NAMES);
-    return enabledServices;
-  }
-  if (envValue.trim() === "") {
-    enabledServices = /* @__PURE__ */ new Set();
-    return enabledServices;
-  }
-  const requested = envValue.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
-  const valid = /* @__PURE__ */ new Set();
-  const unknown = [];
-  for (const service of requested) {
-    if (SERVICE_NAMES.includes(service)) {
-      valid.add(service);
-    } else {
-      unknown.push(service);
-    }
-  }
-  if (unknown.length > 0) {
-    console.warn(
-      `[google-workspace-mcp] Unknown services: ${unknown.join(", ")}. Valid: ${SERVICE_NAMES.join(", ")}`
-    );
-  }
-  enabledServices = valid;
-  return enabledServices;
-}
-function isServiceEnabled(service) {
-  return getEnabledServices().has(service);
-}
-function areUnifiedToolsEnabled() {
-  const enabled = getEnabledServices();
-  return UNIFIED_REQUIRED_SERVICES.every((s) => enabled.has(s));
-}
+// src/config/index.ts
+init_services();
 
 // src/tools/definitions.ts
 var driveTools = [
@@ -5109,9 +5146,6 @@ function formatBytes(bytes, options = {}) {
   const formatted = value.toFixed(precision);
   return `${formatted} ${BYTE_UNITS[unitIndex]}`;
 }
-function formatBytesCompact(bytes, nullValue = "N/A") {
-  return formatBytes(bytes, { precision: 1, nullValue });
-}
 
 // src/schemas/drive.ts
 import { z } from "zod";
@@ -6261,19 +6295,29 @@ async function handleSearch(drive2, args) {
     includeItemsFromAllDrives: true,
     supportsAllDrives: true
   });
-  const fileList = res.data.files?.map((f) => `${f.name} (${f.mimeType})`).join("\n") || "";
+  const files = res.data.files?.map((f) => ({
+    id: f.id,
+    name: f.name,
+    mimeType: f.mimeType,
+    modifiedTime: f.modifiedTime,
+    size: f.size
+  })) || [];
   log("Search results", {
     query: userQuery,
-    resultCount: res.data.files?.length
+    resultCount: files.length
   });
-  let response = `Found ${res.data.files?.length ?? 0} files:
-${fileList}`;
+  let textResponse = `Found ${files.length} files:
+
+${toToon({ files })}`;
   if (res.data.nextPageToken) {
-    response += `
+    textResponse += `
 
 More results available. Use pageToken: ${res.data.nextPageToken}`;
   }
-  return successResponse(response);
+  return structuredResponse(textResponse, {
+    files,
+    nextPageToken: res.data.nextPageToken || null
+  });
 }
 async function handleCreateTextFile(drive2, args) {
   const validation = validateArgs(CreateTextFileSchema, args);
@@ -6736,33 +6780,23 @@ async function handleGetSharing(drive2, args) {
     "List permissions"
   );
   const permissionList = permissions.data.permissions || [];
-  const formattedPermissions = permissionList.map((p) => {
-    let target = "";
-    if (p.type === "anyone") {
-      target = "Anyone with the link";
-    } else if (p.type === "domain") {
-      target = `Anyone in ${p.domain}`;
-    } else {
-      target = p.emailAddress || p.displayName || "Unknown";
-    }
-    return `\u2022 ${target}: ${p.role} (ID: ${p.id})`;
-  }).join("\n");
+  const permissionData = permissionList.map((p) => ({
+    id: p.id,
+    role: p.role,
+    type: p.type,
+    emailAddress: p.emailAddress,
+    domain: p.domain,
+    displayName: p.displayName
+  }));
   const textResponse = `Sharing settings for "${file.data.name}":
 
-${formattedPermissions}
+${toToon({ permissions: permissionData })}
 
 Link: ${file.data.webViewLink}`;
   return structuredResponse(textResponse, {
     fileName: file.data.name,
     webViewLink: file.data.webViewLink,
-    permissions: permissionList.map((p) => ({
-      id: p.id,
-      role: p.role,
-      type: p.type,
-      emailAddress: p.emailAddress,
-      domain: p.domain,
-      displayName: p.displayName
-    }))
+    permissions: permissionData
   });
 }
 async function handleListRevisions(drive2, args) {
@@ -6796,27 +6830,22 @@ async function handleListRevisions(drive2, args) {
   if (revisionList.length === 0) {
     return successResponse(`No revisions found for "${file.data.name}".`);
   }
-  const formattedRevisions = revisionList.map((r, idx) => {
-    const author = r.lastModifyingUser?.displayName || r.lastModifyingUser?.emailAddress || "Unknown";
-    const sizeStr = formatBytes(r.size);
-    const keepForever = r.keepForever ? " (pinned)" : "";
-    return `${idx + 1}. ID: ${r.id} | ${r.modifiedTime} | ${author} | ${sizeStr}${keepForever}`;
-  }).join("\n");
+  const revisionData = revisionList.map((r) => ({
+    id: r.id,
+    modifiedTime: r.modifiedTime,
+    size: r.size,
+    keepForever: r.keepForever,
+    lastModifyingUser: r.lastModifyingUser ? {
+      displayName: r.lastModifyingUser.displayName,
+      emailAddress: r.lastModifyingUser.emailAddress
+    } : void 0
+  }));
   const textResponse = `Revisions for "${file.data.name}" (${revisionList.length} found):
 
-${formattedRevisions}`;
+${toToon({ revisions: revisionData })}`;
   return structuredResponse(textResponse, {
     fileName: file.data.name,
-    revisions: revisionList.map((r) => ({
-      id: r.id,
-      modifiedTime: r.modifiedTime,
-      size: r.size,
-      keepForever: r.keepForever,
-      lastModifyingUser: r.lastModifyingUser ? {
-        displayName: r.lastModifyingUser.displayName,
-        emailAddress: r.lastModifyingUser.emailAddress
-      } : void 0
-    }))
+    revisions: revisionData
   });
 }
 async function handleRestoreRevision(drive2, args) {
@@ -7438,22 +7467,18 @@ async function handleListTrash(drive2, args) {
       nextPageToken: null
     });
   }
-  const fileList = files.map((f) => {
-    const icon = f.mimeType === FOLDER_MIME_TYPE ? "\u{1F4C1}" : "\u{1F4C4}";
-    const size = f.mimeType === FOLDER_MIME_TYPE ? "" : ` (${formatBytesCompact(f.size)})`;
-    return `${icon} ${f.name}${size} - ID: ${f.id}`;
-  }).join("\n");
+  const fileData = files.map((f) => ({
+    id: f.id,
+    name: f.name,
+    mimeType: f.mimeType,
+    size: f.size,
+    trashedTime: f.trashedTime
+  }));
   const textResponse = `Trash contents (${files.length} items):
 
-${fileList}` + (response.data.nextPageToken ? "\n\n(More items available - use nextPageToken to continue)" : "");
+${toToon({ files: fileData })}` + (response.data.nextPageToken ? "\n\n(More items available - use nextPageToken to continue)" : "");
   return structuredResponse(textResponse, {
-    files: files.map((f) => ({
-      id: f.id,
-      name: f.name,
-      mimeType: f.mimeType,
-      size: f.size,
-      trashedTime: f.trashedTime
-    })),
+    files: fileData,
     nextPageToken: response.data.nextPageToken || null
   });
 }
@@ -8538,9 +8563,9 @@ async function listSheetTabs(sheets, spreadsheetId) {
     rowCount: sheet.properties?.gridProperties?.rowCount,
     columnCount: sheet.properties?.gridProperties?.columnCount
   })) || [];
-  const tabList = tabs.map((t) => `${t.index}: ${t.title} (${t.rowCount}x${t.columnCount})`).join("\n");
   return structuredResponse(`Spreadsheet has ${tabs.length} tab(s):
-${tabList}`, {
+
+${toToon({ tabs })}`, {
     spreadsheetId,
     tabs
   });
@@ -9749,13 +9774,6 @@ function formatEventTime(eventTime) {
   }
   return "Unknown";
 }
-function formatEventSummary(event) {
-  const start = formatEventTime(event.start);
-  const end = formatEventTime(event.end);
-  const isAllDay = !!event.start?.date;
-  const timeStr = isAllDay ? start : `${start} - ${end}`;
-  return `${event.summary || "(No title)"} | ${timeStr}`;
-}
 async function handleListCalendars(calendar, args) {
   const validation = validateArgs(ListCalendarsSchema, args);
   if (!validation.success) return validation.response;
@@ -9768,26 +9786,23 @@ async function handleListCalendars(calendar, args) {
   if (calendars.length === 0) {
     return structuredResponse("No calendars found.", { calendars: [] });
   }
-  const formattedCalendars = calendars.map((cal) => {
-    const primary = cal.primary ? " (Primary)" : "";
-    const access2 = cal.accessRole ? ` [${cal.accessRole}]` : "";
-    return `${cal.summary || cal.id}${primary}${access2} - ID: ${cal.id}`;
-  }).join("\n");
+  const calendarData = calendars.map((cal) => ({
+    id: cal.id,
+    summary: cal.summary,
+    description: cal.description,
+    primary: cal.primary,
+    accessRole: cal.accessRole,
+    backgroundColor: cal.backgroundColor,
+    foregroundColor: cal.foregroundColor,
+    timeZone: cal.timeZone
+  }));
   log("Listed calendars", { count: calendars.length });
-  return structuredResponse(`Found ${calendars.length} calendar(s):
+  return structuredResponse(
+    `Found ${calendars.length} calendar(s):
 
-${formattedCalendars}`, {
-    calendars: calendars.map((cal) => ({
-      id: cal.id,
-      summary: cal.summary,
-      description: cal.description,
-      primary: cal.primary,
-      accessRole: cal.accessRole,
-      backgroundColor: cal.backgroundColor,
-      foregroundColor: cal.foregroundColor,
-      timeZone: cal.timeZone
-    }))
-  });
+${toToon({ calendars: calendarData })}`,
+    { calendars: calendarData }
+  );
 }
 async function handleListEvents(calendar, args) {
   const validation = validateArgs(ListEventsSchema, args);
@@ -9810,10 +9825,29 @@ async function handleListEvents(calendar, args) {
       nextPageToken: null
     });
   }
-  const formattedEvents = events.map((event) => `- ${formatEventSummary(event)}`).join("\n");
+  const eventData = events.map((event) => ({
+    id: event.id,
+    summary: event.summary,
+    description: event.description,
+    location: event.location,
+    start: event.start,
+    end: event.end,
+    status: event.status,
+    htmlLink: event.htmlLink,
+    hangoutLink: event.hangoutLink,
+    attendees: event.attendees?.map((a) => ({
+      email: a.email,
+      displayName: a.displayName,
+      responseStatus: a.responseStatus,
+      optional: a.optional
+    })),
+    organizer: event.organizer,
+    creator: event.creator,
+    recurringEventId: event.recurringEventId
+  }));
   let textResponse = `Found ${events.length} event(s):
 
-${formattedEvents}`;
+${toToon({ events: eventData })}`;
   if (response.data.nextPageToken) {
     textResponse += `
 
@@ -9821,26 +9855,7 @@ More events available. Use pageToken: ${response.data.nextPageToken}`;
   }
   log("Listed events", { calendarId, count: events.length });
   return structuredResponse(textResponse, {
-    events: events.map((event) => ({
-      id: event.id,
-      summary: event.summary,
-      description: event.description,
-      location: event.location,
-      start: event.start,
-      end: event.end,
-      status: event.status,
-      htmlLink: event.htmlLink,
-      hangoutLink: event.hangoutLink,
-      attendees: event.attendees?.map((a) => ({
-        email: a.email,
-        displayName: a.displayName,
-        responseStatus: a.responseStatus,
-        optional: a.optional
-      })),
-      organizer: event.organizer,
-      creator: event.creator,
-      recurringEventId: event.recurringEventId
-    })),
+    events: eventData,
     nextPageToken: response.data.nextPageToken || null
   });
 }
@@ -10425,10 +10440,9 @@ async function handleSearchEmails(gmail, args) {
       };
     })
   );
-  const formattedList = messageDetails.map((m) => `- [${m.id}] ${m.subject || "(No subject)"} from ${m.from || "Unknown"}`).join("\n");
   let textResponse = `Found ${response.data.resultSizeEstimate} email(s):
 
-${formattedList}`;
+${toToon({ messages: messageDetails })}`;
   if (response.data.nextPageToken) {
     textResponse += `
 
@@ -10629,28 +10643,31 @@ async function handleListLabels(gmail, args) {
   if (!includeSystemLabels) {
     labels = userLabels;
   }
-  const formattedLabels = labels.map((l) => `- ${l.name} [${l.id}] (${l.type})`).join("\n");
+  const labelData = labels.map((l) => ({
+    id: l.id,
+    name: l.name,
+    type: l.type,
+    messageListVisibility: l.messageListVisibility,
+    labelListVisibility: l.labelListVisibility,
+    color: l.color,
+    messagesTotal: l.messagesTotal,
+    messagesUnread: l.messagesUnread
+  }));
   log("Listed labels", {
     total: labels.length,
     system: systemLabels.length,
     user: userLabels.length
   });
-  return structuredResponse(`Found ${labels.length} label(s):
+  return structuredResponse(
+    `Found ${labels.length} label(s):
 
-${formattedLabels}`, {
-    labels: labels.map((l) => ({
-      id: l.id,
-      name: l.name,
-      type: l.type,
-      messageListVisibility: l.messageListVisibility,
-      labelListVisibility: l.labelListVisibility,
-      color: l.color,
-      messagesTotal: l.messagesTotal,
-      messagesUnread: l.messagesUnread
-    })),
-    systemLabelCount: systemLabels.length,
-    userLabelCount: userLabels.length
-  });
+${toToon({ labels: labelData })}`,
+    {
+      labels: labelData,
+      systemLabelCount: systemLabels.length,
+      userLabelCount: userLabels.length
+    }
+  );
 }
 async function handleGetOrCreateLabel(gmail, args) {
   const validation = validateArgs(GetOrCreateLabelSchema, args);
@@ -10823,26 +10840,20 @@ ${actionStr || "None"}`,
   if (filters.length === 0) {
     return structuredResponse("No filters found.", { filters: [] });
   }
-  const formattedFilters = filters.map((f) => {
-    const criteria = f.criteria || {};
-    const criteriaStr = [
-      criteria.from ? `from:${criteria.from}` : null,
-      criteria.to ? `to:${criteria.to}` : null,
-      criteria.subject ? `subject:${criteria.subject}` : null,
-      criteria.query ? `query:${criteria.query}` : null
-    ].filter(Boolean).join(", ");
-    return `- [${f.id}] ${criteriaStr || "(no criteria)"}`;
-  }).join("\n");
+  const filterData = filters.map((f) => ({
+    id: f.id,
+    criteria: f.criteria,
+    action: f.action
+  }));
   log("Listed filters", { count: filters.length });
-  return structuredResponse(`Found ${filters.length} filter(s):
+  return structuredResponse(
+    `Found ${filters.length} filter(s):
 
-${formattedFilters}`, {
-    filters: filters.map((f) => ({
-      id: f.id,
-      criteria: f.criteria,
-      action: f.action
-    }))
-  });
+${toToon({ filters: filterData })}`,
+    {
+      filters: filterData
+    }
+  );
 }
 async function handleDeleteFilter(gmail, args) {
   const validation = validateArgs(DeleteFilterSchema, args);