google-tools-mcp 1.0.8 → 1.0.9

package/README.md

@@ -1,6 +1,6 @@
 # google-tools-mcp
 
-A unified MCP server for Google Workspace — Drive, Docs, Sheets, Gmail, and Calendar — with **146 tools** across 8 categories.
+A unified MCP server for Google Workspace — Drive, Docs, Sheets, Gmail, Calendar, and Forms — with **152 tools** across 9 categories.
 
 All tools are loaded at startup so they're immediately available to your AI agent. No discovery step needed.
 
@@ -10,10 +10,10 @@ Most Google MCP servers split functionality across separate packages. This serve
 
 ## Features
 
-- **146 tools** across 8 categories, all available immediately
-- **Single auth token** — one OAuth flow covers Drive, Docs, Sheets, Gmail, and Calendar
+- **152 tools** across 9 categories, all available immediately
+- **Single auth token** — one OAuth flow covers Drive, Docs, Sheets, Gmail, Calendar, and Forms
 - **Lazy-loading auth** — no browser popup until your first tool call
-- **No lazy tool loading** — all 146 tools are registered eagerly at startup since most MCP clients (including Claude Code) don't support `notifications/tools/list_changed`
+- **No lazy tool loading** — all 150 tools are registered eagerly at startup since most MCP clients (including Claude Code) don't support `notifications/tools/list_changed`
 - **Multi-profile support** — separate tokens per Google account
 - **No telemetry**
 
@@ -23,10 +23,11 @@ Most Google MCP servers split functionality across separate packages. This serve
 
 1. Go to the [Google Cloud Console](https://console.cloud.google.com/)
 2. Create a project (or use an existing one)
-3. Enable the **Google Docs API**, **Google Sheets API**, **Google Drive API**, **Gmail API**, and **Google Calendar API**
-4. Go to **Credentials** → **Create Credentials** → **OAuth Client ID**
-5. Select **Desktop application** as the application type
-6. Download the credentials or note your **Client ID** and **Client Secret**
+3. Enable the **Google Docs API**, **Google Sheets API**, **Google Drive API**, **Gmail API**, **Google Calendar API**, and **Google Forms API**
+4. Go to **OAuth consent screen** and configure it (External is fine for personal use). If your app's publishing status is **Testing** (the default), you must add your Google account as a test user — go to **OAuth consent screen** → **Test users** → **Add users** and enter your email. Without this, Google will block the OAuth flow with an "Access denied" or "app not verified" error.
+5. Go to **Credentials** → **Create Credentials** → **OAuth Client ID**
+6. Select **Desktop application** as the application type
+7. Download the credentials or note your **Client ID** and **Client Secret**
 
 ### Step 2: Provide Your Credentials
 
@@ -168,20 +169,20 @@ This stores tokens in `~/.config/google-tools-mcp/work/` instead of the default
 
 ## Tool Categories
 
-### `files` (16 tools)
+### `files` (17 tools)
 Google Drive file management and content reading.
 
-`listDocuments`, `searchDocuments`, `getDocumentInfo`, `createFolder`, `listFolderContents`, `getFolderInfo`, `moveFile`, `copyFile`, `renameFile`, `deleteFile`, `createDocument`, `createDocumentFromTemplate`, `listSharedDrives`, `listSharedWithMe`, `readFile`, `searchFileContents`
+`listDriveFiles`, `searchDocuments`, `getFileInfo`, `createFolder`, `listFolderContents`, `getFolderInfo`, `moveFile`, `copyFile`, `renameFile`, `deleteFile`, `createDocument`, `createDocumentFromTemplate`, `listSharedDrives`, `listSharedWithMe`, `downloadFile`, `readFile`, `searchFileContents`
 
-### `documents` (23 tools)
+### `documents` (22 tools)
 Google Docs read/write/format with markdown support.
 
-`readDocument`, `appendText`, `insertText`, `deleteRange`, `modifyText`, `findAndReplace`, `insertTable`, `insertTableWithData`, `insertPageBreak`, `insertImage`, `listTabs`, `addTab`, `renameTab`, `applyTextStyle`, `applyParagraphStyle`, `addComment`, `deleteComment`, `getComment`, `listComments`, `replyToComment`, `resolveComment`, `appendMarkdown`, `replaceDocumentWithMarkdown`
+`readDocument`, `appendText`, `deleteRange`, `modifyText`, `findAndReplace`, `insertTable`, `insertTableWithData`, `insertPageBreak`, `insertImage`, `listTabs`, `addTab`, `renameTab`, `applyParagraphStyle`, `getFormatting`, `addComment`, `deleteComment`, `getComment`, `listComments`, `replyToComment`, `resolveComment`, `appendMarkdown`, `replaceDocumentWithMarkdown`
 
-### `spreadsheets` (30 tools)
+### `spreadsheets` (29 tools)
 Google Sheets operations.
 
-`readSpreadsheet`, `writeSpreadsheet`, `batchWrite`, `appendRows`, `clearRange`, `createSpreadsheet`, `getSpreadsheetInfo`, `addSheet`, `deleteSheet`, `duplicateSheet`, `renameSheet`, `formatCells`, `readCellFormat`, `autoResizeColumns`, `freezeRowsAndColumns`, `setColumnWidths`, `addConditionalFormatting`, `copyFormatting`, `setDropdownValidation`, `createTable`, `deleteTable`, `getTable`, `listTables`, `appendTableRows`, `updateTableRange`, `insertChart`, `deleteChart`, `groupRows`, `ungroupAllRows`, `listSpreadsheets`
+`readSpreadsheet`, `writeSpreadsheet`, `batchWrite`, `appendRows`, `clearRange`, `createSpreadsheet`, `getSpreadsheetInfo`, `addSheet`, `deleteSheet`, `duplicateSheet`, `renameSheet`, `formatCells`, `readCellFormat`, `autoResizeColumns`, `freezeRowsAndColumns`, `setColumnWidths`, `addConditionalFormatting`, `copyFormatting`, `setDropdownValidation`, `createTable`, `deleteTable`, `getTable`, `listTables`, `appendTableRows`, `updateTableRange`, `insertChart`, `deleteChart`, `groupRows`, `ungroupAllRows`
 
 ### `email` (19 tools)
 Gmail messages and drafts.
@@ -208,6 +209,11 @@ Google Calendar — events, availability, and calendar management.
 
 `list_calendars`, `get_events`, `manage_event`, `get_busy`, `get_free`, `move_event`, `list_recurring_event_instances`, `manage_calendar`
 
+### `forms` (6 tools)
+Google Forms — create/read forms, manage responses, and publish settings.
+
+`create_form`, `get_form`, `batch_update_form`, `get_form_response`, `list_form_responses`, `set_publish_settings`
+
 ## Environment Variables
 
 | Variable | Required | Description |

package/dist/tools/docs/formatting/getFormatting.js

@@ -102,7 +102,8 @@ export function register(server) {
     server.addTool({
         name: 'getFormatting',
         description: 'Returns the text styling (bold, italic, font, colors, etc.) and paragraph styling ' +
-            '(alignment, headings, spacing, indentation) for a specific range or found text in a Google Doc.',
+            '(alignment, headings, spacing, indentation) for a specific range or found text in a Google Doc. ' +
+            'Returns per-run text styles and per-paragraph styles, so mixed formatting (e.g. bold + italic spans) is fully represented.',
         parameters: GetFormattingParameters,
         execute: async (args, { log }) => {
             const docs = await getDocsClient();

package/dist/tools/index.js

@@ -3,6 +3,8 @@
 //  so lazy-loading doesn't work.)
 import { z } from 'zod';
 import * as fs from 'fs/promises';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
 import { getTokenPath } from '../auth.js';
 import { resetClients } from '../clients.js';
 import { logger } from '../logger.js';
@@ -81,6 +83,23 @@ export async function registerAllTools(server) {
     }
     logger.info(`Loaded all ${Object.keys(CATEGORIES).length} categories at startup.`);
 
+    // --- Help tool (always available) ---
+    server.addTool({
+        name: 'help',
+        description:
+            'Show documentation for google-tools-mcp: setup instructions, available tool categories, environment variables, and troubleshooting. Call this when you need guidance on how to use the Google Workspace tools.',
+        parameters: z.object({}),
+        execute: async () => {
+            const __dirname = path.dirname(fileURLToPath(import.meta.url));
+            const readmePath = path.resolve(__dirname, '..', '..', 'README.md');
+            try {
+                return await fs.readFile(readmePath, 'utf-8');
+            } catch {
+                return 'README not found. Visit https://www.npmjs.com/package/google-tools-mcp for documentation.';
+            }
+        },
+    });
+
     // --- Logout tool (always available) ---
     server.addTool({
         name: 'logout',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "google-tools-mcp",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Combined Google Workspace MCP server (Drive, Docs, Sheets, Gmail) with lazy-loaded tool categories",
   "type": "module",
   "bin": {