mcp-google-multi 6.0.0-beta.4 → 6.0.0

package/skills/google-workspace/reference/contacts.md

@@ -0,0 +1,138 @@
+# contacts
+
+<!-- GENERATED by scripts/gen-skill.ts, do not edit by hand. Regenerate: npm run gen:skill -->
+
+10 curated tools, plus 14 generated tools (Google Discovery parameter names; see `contacts_discover`).
+
+## `contacts_create`
+
+Class: create
+
+Create a new contact
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `givenName` | string | required | First name |
+| `familyName` | string | optional | Last name |
+| `email` | string | optional | Email address |
+| `emailType` | enum | optional | Email type (default: work) |
+| `phone` | string | optional | Phone number |
+| `phoneType` | enum | optional | Phone type (default: mobile) |
+| `organization` | string | optional | Company/organization name |
+| `jobTitle` | string | optional | Job title |
+
+## `contacts_delete`
+
+Class: delete
+
+Delete a contact (permanent, cannot be undone)
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `resourceName` | string | required | Contact resource name (e.g. "people/c1234567890") |
+
+## `contacts_get`
+
+Class: read
+
+Get a single contact by resource name
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `resourceName` | string | required | Contact resource name (e.g. "people/c1234567890") |
+
+## `contacts_group_create`
+
+Class: create
+
+Create a new contact group (label)
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `name` | string | required | Name for the contact group |
+
+## `contacts_group_members`
+
+Class: read
+
+List members of a contact group
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `groupResourceName` | string | required | Contact group resource name (e.g. "contactGroups/abc123") |
+| `maxMembers` | number | optional | Max member resource names to return (default: 100) |
+
+## `contacts_groups_list`
+
+Class: read
+
+List all contact groups (labels)
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `pageSize` | number | optional | Max groups to return (default: 100) |
+
+## `contacts_list`
+
+Class: read
+
+List all contacts (paginated)
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `pageSize` | number | optional | Number of contacts per page (default: 50) |
+| `pageToken` | string | optional | Page token for pagination |
+| `sortOrder` | enum | optional | Sort order (default: FIRST_NAME_ASCENDING) |
+| `requireEmail` | boolean | optional | Only return contacts with at least one email address. Filtering happens after the page is fetched, so the returned page can hold fewer than pageSize contacts; nextPageToken still continues the underlying, unfiltered listing |
+| `requireName` | boolean | optional | Only return contacts with a name. Filtering happens after the page is fetched, so the returned page can hold fewer than pageSize contacts; nextPageToken still continues the underlying, unfiltered listing |
+
+## `contacts_resolve`
+
+Class: read
+
+Resolve a free-text name/alias to ONE canonical email address (ranked + tie-broken), so you need not hand-expand transliteration OR-queries. Returns a single confident match, an explicit ambiguous candidate list, or null when nothing matches. For picking a recipient before gmail_send.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `name` | string | required | Free-text name or alias to resolve (e.g. "Zoe") |
+| `maxCandidates` | number | optional | Max candidates to return when ambiguous (1-10, default: 5) |
+| `includeOtherContacts` | boolean | optional | Also search auto-saved "other contacts" (people you have emailed but not saved). Default true. |
+
+## `contacts_search`
+
+Class: read
+
+Search contacts by name, email, phone, or organization
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `query` | string | required | Search query (prefix matching on names, emails, phones, organizations) |
+| `pageSize` | number | optional | Max results (1-30, default: 10) |
+
+## `contacts_update`
+
+Class: update
+
+Update an existing contact (reads current etag automatically)
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `resourceName` | string | required | Contact resource name (e.g. "people/c1234567890") |
+| `givenName` | string | optional | Updated first name |
+| `familyName` | string | optional | Updated last name |
+| `email` | string | optional | Updated email address |
+| `emailType` | enum | optional | Email type |
+| `phone` | string | optional | Updated phone number |
+| `phoneType` | enum | optional | Phone type |
+| `organization` | string | optional | Updated company/organization name |
+| `jobTitle` | string | optional | Updated job title |

package/skills/google-workspace/reference/docs.md

@@ -0,0 +1,395 @@
+# docs
+
+<!-- GENERATED by scripts/gen-skill.ts, do not edit by hand. Regenerate: npm run gen:skill -->
+
+27 curated tools.
+
+## `docs_add_tab`
+
+Class: create
+
+Add a new tab to a document. Can be a top-level tab or nested as a child of an existing tab.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `title` | string | required | Tab title |
+| `parentTabId` | string | optional | Parent tab ID (omit for top-level) |
+| `index` | number | optional | Position among siblings |
+
+## `docs_batch_update`
+
+Class: update
+
+Generic documents.batchUpdate pass-through. Accepts the full Request union (40 types). See https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/request
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `requests` | array | required | Array of Request objects, each with one request-type key |
+| `writeControl` | object | optional | Optional optimistic concurrency control |
+
+## `docs_create`
+
+Class: create
+
+Create a new Google Docs document
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `title` | string | required | Document title |
+
+## `docs_create_footer`
+
+Class: create
+
+Create a footer for the document or a specific section
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `sectionBreakIndex` | number | optional |  |
+
+## `docs_create_header`
+
+Class: create
+
+Create a header for the document or for a specific section. The new header is empty; insert text into it with docs_insert_text targeting its segmentId.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `sectionBreakIndex` | number | optional | Anchor to a specific section break; omit to apply to the document |
+
+## `docs_create_named_range`
+
+Class: create
+
+Tag a range of text with a name. Multiple ranges can share the same name. Used as a template anchor for docs_replace_named_range_content.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `name` | string | required | Name (1-256 chars). Need not be unique. |
+| `startIndex` | number | required | Range start (inclusive) |
+| `endIndex` | number | required | Range end (exclusive) |
+
+## `docs_create_paragraph_bullets`
+
+Class: create
+
+Turn paragraphs in a range into a bulleted or numbered list
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `startIndex` | number | required |  |
+| `endIndex` | number | required |  |
+| `bulletPreset` | enum | required | Bullet/numbering preset |
+
+## `docs_delete_footer`
+
+Class: delete
+
+Delete a footer by its footerId
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `footerId` | string | required | Footer ID |
+
+## `docs_delete_header`
+
+Class: delete
+
+Delete a header by its headerId
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `headerId` | string | required | Header ID (from docs_get or createHeader reply) |
+
+## `docs_delete_named_range`
+
+Class: delete
+
+Delete a named range by its ID or by name. Removes every range matching the identifier.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `namedRangeId` | string | optional | Specific named range ID |
+| `name` | string | optional | Name (deletes ALL named ranges with this name) |
+
+## `docs_delete_paragraph_bullets`
+
+Class: delete
+
+Strip bullet/number formatting from paragraphs in a range
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `startIndex` | number | required |  |
+| `endIndex` | number | required |  |
+
+## `docs_delete_range`
+
+Class: delete
+
+Delete content in a character index range within a document
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `startIndex` | number | required | Start index (inclusive, 1-based) |
+| `endIndex` | number | required | End index (exclusive) |
+
+## `docs_delete_tab`
+
+Class: delete
+
+Delete a tab and all of its descendant tabs
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `tabId` | string | required | Tab ID |
+
+## `docs_get`
+
+Class: read
+
+Get document metadata (title, revision, named ranges). Optionally include tab content and choose a suggestionsViewMode.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `documentId` | string | required | Google Docs document ID |
+| `includeTabsContent` | boolean | optional | Include full content for every tab (default: false — first tab only) |
+| `suggestionsViewMode` | enum | optional | How suggestions render in the returned body |
+
+## `docs_insert_inline_image`
+
+Class: create
+
+Insert a publicly-accessible image (PNG/JPEG/GIF, <50MB, <25MP, URL <2KB) inline at an index or at the document end
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `uri` | string | required | Public image URL |
+| `index` | number | optional | Insert position; omit to append at the end |
+| `width` | number | optional | Width in points (omit for natural size) |
+| `height` | number | optional | Height in points |
+
+## `docs_insert_page_break`
+
+Class: create
+
+Insert a page break at a position or at the document end
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `index` | number | optional | Insert position; omit to append |
+
+## `docs_insert_section_break`
+
+Class: create
+
+Insert a section break at a position. CONTINUOUS keeps the same page; NEXT_PAGE starts a new page.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `index` | number | optional |  |
+| `sectionType` | enum | optional |  |
+
+## `docs_insert_table`
+
+Class: create
+
+Insert a table into a document at a specific position
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `rows` | number | required | Number of rows |
+| `columns` | number | required | Number of columns |
+| `index` | number | optional | Character index to insert at. Omit to append at the end |
+
+## `docs_insert_text`
+
+Class: create
+
+Insert text into a document at a specific position or at the end
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `text` | string | required | Text to insert |
+| `index` | number | optional | Character index to insert at (1-based). Omit to append at the end |
+
+## `docs_modify_table`
+
+Class: update
+
+Mutate a table by operation: insertRow, insertColumn, deleteRow, deleteColumn, mergeCells, unmergeCells. Locate the cell with tableStartIndex (the table's start index in the doc) plus rowIndex/columnIndex (0-based).
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `operation` | enum | required |  |
+| `tableStartIndex` | number | required | Start index of the table in the document |
+| `rowIndex` | number | required | Target row (0-based) |
+| `columnIndex` | number | required | Target column (0-based) |
+| `insertBelow` | boolean | optional | insertRow only: insert below the target row (default: false) |
+| `insertRight` | boolean | optional | insertColumn only: insert right of the target column (default: false) |
+| `rowSpan` | number | optional | mergeCells only: how many rows the merged cell spans (default 1) |
+| `columnSpan` | number | optional | mergeCells/unmergeCells: column span (default 1) |
+
+## `docs_read`
+
+Class: read
+
+Read document content as plain text with a heading index (returns up to maxChars characters per call). Pass heading or headingIndex to read one section, tabId to read a specific tab.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias; "*" = all accounts; omit for the default account |
+| `documentId` | string | required | Google Docs document ID |
+| `heading` | string | optional | Read only the section under this heading (case-insensitive; exact match first, then substring) |
+| `headingIndex` | integer | optional | Read only the section at this position in the headings array (the `i` field) |
+| `tabId` | string | optional | Read a specific tab instead of the first tab |
+| `maxChars` | number | optional | Max characters of text to return (default: 50000) |
+| `offset` | number | optional | Character offset to continue a truncated read |
+
+## `docs_replace_named_range_content`
+
+Class: update
+
+Replace the content of every named range matching the identifier with the supplied text. Real mail-merge primitive — far more robust than replaceAllText for templated docs.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `namedRangeId` | string | optional | Specific named range ID |
+| `namedRangeName` | string | optional | Name to match (replaces ALL ranges with this name) |
+| `text` | string | required | Replacement text |
+
+## `docs_replace_text`
+
+Class: update
+
+Find and replace text in a document. Pass findText/replaceText for a single pair, or replacements for several pairs applied in one batchUpdate.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `findText` | string | optional | Text to search for. Use with replaceText; exactly one of this pair or `replacements` is required. |
+| `replaceText` | string | optional | Replacement text for findText |
+| `matchCase` | boolean | optional | Case-sensitive match (default: true) |
+| `replacements` | array | optional | Several find/replace pairs applied in one batchUpdate, each returning its own count. Exactly one of this or findText/replaceText is required. |
+
+## `docs_update_document_style`
+
+Class: update
+
+Update document-level styling (page size, margins, headers/footers behavior). Only supplied fields are applied.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `pageWidth` | number | optional | Page width in points (e.g. 595 = A4) |
+| `pageHeight` | number | optional | Page height in points (e.g. 842 = A4) |
+| `marginTop` | number | optional | Margin in points |
+| `marginBottom` | number | optional |  |
+| `marginLeft` | number | optional |  |
+| `marginRight` | number | optional |  |
+| `marginHeader` | number | optional |  |
+| `marginFooter` | number | optional |  |
+| `pageNumberStart` | number | optional |  |
+| `useFirstPageHeaderFooter` | boolean | optional |  |
+| `useEvenPageHeaderFooter` | boolean | optional |  |
+| `useCustomHeaderFooterMargins` | boolean | optional |  |
+
+## `docs_update_paragraph_style`
+
+Class: update
+
+Update paragraph styling (alignment, heading, indents, spacing) across a range. Only supplied fields are applied.
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `startIndex` | number | required |  |
+| `endIndex` | number | required |  |
+| `namedStyleType` | enum | optional |  |
+| `alignment` | enum | optional |  |
+| `lineSpacing` | number | optional | Line spacing as percent (100 = single-space) |
+| `spaceAbove` | number | optional | Space above paragraph, in points |
+| `spaceBelow` | number | optional | Space below paragraph, in points |
+| `indentStart` | number | optional | Start indent in points |
+| `indentEnd` | number | optional | End indent in points |
+| `indentFirstLine` | number | optional | First-line indent in points |
+| `direction` | enum | optional |  |
+| `keepLinesTogether` | boolean | optional |  |
+| `keepWithNext` | boolean | optional |  |
+| `avoidWidowAndOrphan` | boolean | optional |  |
+
+## `docs_update_style`
+
+Class: update
+
+Update text formatting (bold, italic, underline, font, size) for a range
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `startIndex` | number | required | Start index (inclusive, 1-based) |
+| `endIndex` | number | required | End index (exclusive) |
+| `bold` | boolean | optional | Set bold |
+| `italic` | boolean | optional | Set italic |
+| `underline` | boolean | optional | Set underline |
+| `fontSize` | number | optional | Font size in points |
+| `fontFamily` | string | optional | Font family name (e.g. "Arial", "Times New Roman") |
+
+## `docs_update_tab_properties`
+
+Class: update
+
+Rename a tab, change its position, or move it under a different parent
+
+| Argument | Type | Required | Description |
+|---|---|---|---|
+| `account` | string | optional | Google account alias |
+| `documentId` | string | required | Google Docs document ID |
+| `tabId` | string | required | Tab ID |
+| `title` | string | optional |  |
+| `index` | number | optional |  |
+| `parentTabId` | string | optional |  |