@dguido/google-workspace-mcp 1.0.0 → 1.2.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)