mcp-gsheets 1.0.0 → 1.4.1

package/README.md

@@ -4,6 +4,7 @@
   <img width="380" height="200" src="https://glama.ai/mcp/servers/@freema/mcp-gsheets/badge" />
 </a>
 
+[![npm version](https://badge.fury.io/js/mcp-gsheets.svg)](https://www.npmjs.com/package/mcp-gsheets)
 ![CI](https://github.com/freema/mcp-gsheets/workflows/CI/badge.svg)
 ![Coverage](https://codecov.io/gh/freema/mcp-gsheets/branch/main/graph/badge.svg)
 ![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
@@ -92,6 +93,31 @@ If you prefer manual configuration, add to your Claude Desktop config:
 }
 ```
 
+#### Alternative: JSON String Authentication
+
+Instead of using a file path, you can provide the service account credentials directly as a JSON string. This is useful for containerized environments, CI/CD pipelines, or when you want to avoid managing credential files.
+
+```json
+{
+  "mcpServers": {
+    "mcp-gsheets": {
+      "command": "node",
+      "args": ["/absolute/path/to/mcp-gsheets/dist/index.js"],
+      "env": {
+        "GOOGLE_PROJECT_ID": "your-project-id",
+        "GOOGLE_SERVICE_ACCOUNT_KEY": "{\"type\":\"service_account\",\"project_id\":\"your-project\",\"private_key_id\":\"...\",\"private_key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"client_email\":\"...@....iam.gserviceaccount.com\",\"client_id\":\"...\",\"auth_uri\":\"https://accounts.google.com/o/oauth2/auth\",\"token_uri\":\"https://oauth2.googleapis.com/token\",\"auth_provider_x509_cert_url\":\"https://www.googleapis.com/oauth2/v1/certs\",\"client_x509_cert_url\":\"...\"}"
+      }
+    }
+  }
+}
+```
+
+**Note**: When using `GOOGLE_SERVICE_ACCOUNT_KEY`:
+- The entire JSON must be on a single line
+- All quotes must be escaped with backslashes
+- Newlines in the private key must be represented as `\\n`
+- If the JSON includes a `project_id`, you can omit `GOOGLE_PROJECT_ID`
+
 Restart Claude Desktop after adding the configuration.
 
 ## 📦 Build & Development
@@ -179,6 +205,10 @@ npm run dev  # Watch mode with auto-reload
 - `sheets_copy_to` - Copy to another spreadsheet
 - `sheets_update_sheet_properties` - Update sheet settings
 
+### Batch Operations
+- `sheets_batch_delete_sheets` - Delete multiple sheets at once
+- `sheets_batch_format_cells` - Format multiple cell ranges at once
+
 ### Cell Formatting
 - `sheets_format_cells` - Format cells (colors, fonts, alignment, number formats)
 - `sheets_update_borders` - Add or modify cell borders
@@ -186,6 +216,11 @@ npm run dev  # Watch mode with auto-reload
 - `sheets_unmerge_cells` - Unmerge previously merged cells
 - `sheets_add_conditional_formatting` - Add conditional formatting rules
 
+### Charts
+- `sheets_create_chart` - Create various types of charts
+- `sheets_update_chart` - Modify existing charts
+- `sheets_delete_chart` - Remove charts
+
 ## 🔧 Code Quality
 
 ### Linting
@@ -220,8 +255,9 @@ npm run typecheck
 ### Common Issues
 
 **"Authentication failed"**
-- Verify JSON key path is absolute and correct
-- Check GOOGLE_PROJECT_ID matches your project
+- If using file-based auth: Verify JSON key path is absolute and correct
+- If using JSON string auth: Ensure JSON is properly escaped and valid
+- Check GOOGLE_PROJECT_ID matches your project (or is included in JSON)
 - Ensure Sheets API is enabled
 
 **"Permission denied"**
@@ -259,6 +295,10 @@ Use `sheets_get_metadata` to list all sheets with their IDs.
 4. Check rate limits for large operations
 5. Use `sheets_check_access` to verify permissions before operations
 
+## 📋 Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for a list of changes in each version.
+
 ## 🤝 Contributing
 
 1. Fork the repository