@aaronsb/google-workspace-mcp 4.2.1 → 4.3.0

package/build/factory/manifest/contacts.yaml

@@ -0,0 +1,247 @@
+tool_name: manage_contacts
+description: "Search, read, create, update and delete Google Contacts: your saved contacts, the addresses you have corresponded with but never saved, and your organization's directory."
+requires_email: true
+google_service: people
+
+# The People API asks the caller to name every field it wants back, on every call, via
+# `personFields` or `readMask`. Omit the mask and the call is REJECTED outright — this is
+# not a shape that degrades to a sensible default.
+#
+# Those masks live in `defaults` rather than `params` so they never enter the generated
+# schema. An agent asking "who is Dana" should not first have to know that a birthday is
+# spelled `birthdays` and lives behind a different parameter name depending on which of
+# the seven operations it picked. The masks also differ per operation because Google
+# restricts them per operation, which is exactly the routing this tool exists to absorb.
+#
+# `sources` is left out of the schema for a sharper reason: its legal values are NOT the
+# same across operations. The contact operations take READ_SOURCE_TYPE_*, the directory
+# operations take DIRECTORY_SOURCE_TYPE_*, and generateSchema keeps only the FIRST
+# declaration of a param name — so a single advertised `sources` enum would be wrong for
+# whichever half lost the race.
+operations:
+
+  # --- Your own contacts ---
+
+  list:
+    type: list
+    description: "list your saved contacts"
+    resource: people.connections.list
+    params:
+      maxResults:
+        type: number
+        description: "Max people to return (default 25). Capped per operation: 30 for `search` and `searchOther`, 100 for everything else."
+        default: 25
+        max: 100
+        maps_to: pageSize
+      pageToken:
+        type: string
+        description: "Continue from where a previous page stopped — pass the token that response printed"
+      sortOrder:
+        type: string
+        description: "Order for `list` — by first name, by last name, or most recently changed first"
+        enum: [firstName, lastName, lastModified]
+    defaults:
+      # connections.list reads one person's connections, and the person is always the
+      # authenticated account. `people/me` is Google's alias for it, so the agent never
+      # has to know its own resource name.
+      resourceName: people/me
+      personFields: names,emailAddresses,phoneNumbers,organizations,metadata
+      sortOrder: firstName
+
+  search:
+    type: list
+    description: "search your saved contacts by name, email, nickname or phone"
+    resource: people.searchContacts
+    params:
+      query:
+        type: string
+        description: "Text to match against names, email addresses, nicknames and phone numbers. Matching is by PREFIX: `ann` finds Anna, `nna` finds nobody."
+        required: true
+      maxResults:
+        type: number
+        description: "Max people to return (default 25). Capped per operation: 30 for `search` and `searchOther`, 100 for everything else."
+        default: 25
+        max: 30
+        maps_to: pageSize
+    defaults:
+      readMask: names,emailAddresses,phoneNumbers,organizations,metadata
+
+  get:
+    type: detail
+    description: "get one person in full — addresses, birthday, notes, relations"
+    resource: people.get
+    params:
+      contactId:
+        type: string
+        description: "Person id as `list` or `search` printed it (e.g. `people/c1234567890`). A bare id without the `people/` prefix is accepted."
+        required: true
+        maps_to: resourceName
+    defaults:
+      personFields: names,nicknames,emailAddresses,phoneNumbers,addresses,organizations,birthdays,biographies,urls,relations,memberships,photos,metadata
+
+  # The Person body is built by the patch, not declared here. Every field the People API
+  # wants is a parallel array of objects — `names: [{givenName, familyName}]` — and any
+  # param this manifest declares that Google does not recognise as a query parameter goes
+  # into the request body VERBATIM. Declared flat, `name: "Ada Lovelace"` would be sent as
+  # a top-level `name` field, which Google ignores, producing a contact with no name and
+  # no error. So these are declared for the SCHEMA and converted before the call.
+  create:
+    type: action
+    description: "create a new contact"
+    resource: people.createContact
+    params:
+      name:
+        type: string
+        description: "Full name, e.g. `Ada Lovelace`. Split into given and family name on the way in; a single word becomes the given name."
+      contactEmail:
+        type: string
+        description: "The contact's email address. (`email` is the account making the call, not the person being saved.) On `update` this REPLACES every address the contact has — pass an empty string to clear them."
+      phone:
+        type: string
+        description: "Phone number, in whatever form you have it — Google normalizes it. On `update` this REPLACES every number the contact has — pass an empty string to clear them."
+      company:
+        type: string
+        description: "Organization name"
+      jobTitle:
+        type: string
+        description: "Job title within the organization"
+      notes:
+        type: string
+        description: "Free-text note stored on the contact"
+    defaults:
+      # Echoes back EVERY field this operation can write. Live, the shorter read mask
+      # confirmed a create without the note it had just stored — a confirmation that
+      # drops a field the caller supplied is indistinguishable from one that dropped it
+      # on the way in.
+      personFields: names,emailAddresses,phoneNumbers,organizations,biographies,metadata
+
+  # updatePersonFields is not sent from here — the patch derives it from which fields the
+  # caller actually supplied. A fixed list would name fields nobody touched, and naming a
+  # field in updatePersonFields with no value in the body CLEARS it. Declared statically,
+  # this operation would wipe a contact's phone number every time someone corrected a
+  # job title.
+  update:
+    type: action
+    description: "change an existing contact (only the fields you pass; pass an empty string to clear one)"
+    resource: people.updateContact
+    params:
+      contactId:
+        type: string
+        description: "Person id as `list` or `search` printed it (e.g. `people/c1234567890`). A bare id without the `people/` prefix is accepted."
+        required: true
+        maps_to: resourceName
+      name:
+        type: string
+        description: "Full name, e.g. `Ada Lovelace`. Split into given and family name on the way in; a single word becomes the given name."
+      contactEmail:
+        type: string
+        description: "The contact's email address. (`email` is the account making the call, not the person being saved.) On `update` this REPLACES every address the contact has — pass an empty string to clear them."
+      phone:
+        type: string
+        description: "Phone number, in whatever form you have it — Google normalizes it. On `update` this REPLACES every number the contact has — pass an empty string to clear them."
+      company:
+        type: string
+        description: "Organization name"
+      jobTitle:
+        type: string
+        description: "Job title within the organization"
+      notes:
+        type: string
+        description: "Free-text note stored on the contact"
+    defaults:
+      personFields: names,emailAddresses,phoneNumbers,organizations,biographies,metadata
+
+  delete:
+    type: action
+    description: "delete a contact"
+    resource: people.deleteContact
+    params:
+      contactId:
+        type: string
+        description: "Person id as `list` or `search` printed it (e.g. `people/c1234567890`). A bare id without the `people/` prefix is accepted."
+        required: true
+        maps_to: resourceName
+
+  # --- Other contacts: addresses seen in mail, never saved ---
+
+  listOther:
+    type: list
+    description: "list 'other contacts' — addresses you have corresponded with but never saved"
+    resource: otherContacts.list
+    params:
+      maxResults:
+        type: number
+        description: "Max people to return (default 25). Capped per operation: 30 for `search` and `searchOther`, 100 for everything else."
+        default: 25
+        max: 100
+        maps_to: pageSize
+      pageToken:
+        type: string
+        description: "Continue from where a previous page stopped — pass the token that response printed"
+    defaults:
+      # otherContacts accepts a narrower mask than the contact operations do; asking it
+      # for organizations is an error, not an empty field.
+      readMask: names,emailAddresses,phoneNumbers,metadata
+
+  searchOther:
+    type: list
+    description: "search 'other contacts' by name or email"
+    resource: otherContacts.search
+    params:
+      query:
+        type: string
+        description: "Text to match against names, email addresses, nicknames and phone numbers. Matching is by PREFIX: `ann` finds Anna, `nna` finds nobody."
+        required: true
+      maxResults:
+        type: number
+        description: "Max people to return (default 25). Capped per operation: 30 for `search` and `searchOther`, 100 for everything else."
+        default: 25
+        max: 30
+        maps_to: pageSize
+    defaults:
+      readMask: names,emailAddresses,phoneNumbers,metadata
+
+  # --- The organization directory (Google Workspace accounts only) ---
+
+  listDirectory:
+    type: list
+    description: "list people in your organization's directory (Workspace accounts only)"
+    resource: people.listDirectoryPeople
+    params:
+      maxResults:
+        type: number
+        description: "Max people to return (default 25). Capped per operation: 30 for `search` and `searchOther`, 100 for everything else."
+        default: 25
+        max: 100
+        maps_to: pageSize
+      pageToken:
+        type: string
+        description: "Continue from where a previous page stopped — pass the token that response printed"
+    defaults:
+      readMask: names,emailAddresses,phoneNumbers,organizations,metadata
+      # `sources` is REQUIRED here — the directory operations reject a call that does not
+      # say which directory to read. Both value sets are wanted: DOMAIN_PROFILE is the
+      # people with accounts, DOMAIN_CONTACT the shared contacts an admin published.
+      sources: DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE,DIRECTORY_SOURCE_TYPE_DOMAIN_CONTACT
+
+  searchDirectory:
+    type: list
+    description: "search your organization's directory by name or email (Workspace accounts only)"
+    resource: people.searchDirectoryPeople
+    params:
+      query:
+        type: string
+        description: "Text to match against names, email addresses, nicknames and phone numbers. Matching is by PREFIX: `ann` finds Anna, `nna` finds nobody."
+        required: true
+      maxResults:
+        type: number
+        description: "Max people to return (default 25). Capped per operation: 30 for `search` and `searchOther`, 100 for everything else."
+        default: 25
+        max: 100
+        maps_to: pageSize
+      pageToken:
+        type: string
+        description: "Continue from where a previous page stopped — pass the token that response printed"
+    defaults:
+      readMask: names,emailAddresses,phoneNumbers,organizations,metadata
+      sources: DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE,DIRECTORY_SOURCE_TYPE_DOMAIN_CONTACT

package/build/factory/manifest/meet.yaml

@@ -157,3 +157,81 @@ operations:
         description: "Smart note resource name (from listSmartNotes)"
         required: true
         maps_to: name
+
+  # --- Meeting spaces ---
+  #
+  # A space is a standalone meeting link, not attached to a calendar event. For a link on
+  # an event, use `manage_calendar` with `meet: true` — that goes through Calendar and
+  # keeps the two together.
+  #
+  # `createSpace` is the first manage_meet operation that WRITES. Everything above reads
+  # conference records, which `meetings.space.readonly` covers on its own; creating a
+  # space needs `meetings.space.created`, which a read-only account does not hold
+  # (ADR-202). Both handlers are custom: spaces.create declares no parameters at all, so
+  # everything travels in the body, and the response nests the joinable URL.
+
+  createSpace:
+    type: action
+    description: "create a standalone Google Meet link (not attached to a calendar event)"
+    resource: spaces.create
+    params:
+      accessType:
+        type: string
+        enum: ["OPEN", "TRUSTED", "RESTRICTED"]
+        description: "Who can join without knocking. OPEN: anyone with the link. TRUSTED (default): people in your organization, plus invited guests. RESTRICTED: invited guests only."
+      moderation:
+        type: boolean
+        description: "Turn on host controls — the host admits guests and manages who can present or chat."
+
+  activeConferences:
+    type: list
+    description: "list conferences happening RIGHT NOW across your meetings"
+    resource: conferenceRecords.list
+    params:
+      maxResults:
+        type: number
+        description: "Max results per page, as default/ceiling. Differs by operation: `listConferences` 25/100, `listParticipants` 100/250, `listTranscriptEntries` 100/100. (Google's own default for transcript entries is 10; this tool raises it.)"
+        default: 25
+        max: 100
+
+  getSpace:
+    type: detail
+    description: "look up a meeting space by its meeting code or resource name"
+    resource: spaces.get
+    params:
+      space:
+        type: string
+        description: "Meeting code (the abc-mnop-xyz part of a Meet link) or a full spaces/... resource name"
+        required: true
+        maps_to: name
+
+  updateSpace:
+    type: action
+    description: "change who can join a meeting space, or turn host controls on or off"
+    resource: spaces.patch
+    params:
+      space:
+        type: string
+        description: "Meeting code (the abc-mnop-xyz part of a Meet link) or a full spaces/... resource name"
+        required: true
+        maps_to: name
+      accessType:
+        type: string
+        enum: ["OPEN", "TRUSTED", "RESTRICTED"]
+        description: "Who can join without knocking. OPEN: anyone with the link. TRUSTED (default): people in your organization, plus invited guests. RESTRICTED: invited guests only."
+      moderation:
+        type: boolean
+        description: "Turn on host controls — the host admits guests and manages who can present or chat."
+
+  # Ends the meeting for EVERYONE currently in it. There is no undo and no warning to
+  # participants; the call returns an empty body whether or not anyone was in the room.
+  endActiveConference:
+    type: action
+    description: "end the call happening in a space right now, disconnecting everyone in it"
+    resource: spaces.endActiveConference
+    params:
+      space:
+        type: string
+        description: "Meeting code (the abc-mnop-xyz part of a Meet link) or a full spaces/... resource name"
+        required: true
+        maps_to: name

package/build/factory/patches.js

@@ -9,6 +9,7 @@ import { docsPatch } from '../services/docs/patch.js';
 import { meetPatch } from '../services/meet/patch.js';
 import { sheetsPatch } from '../services/sheets/patch.js';
 import { tasksPatch } from '../services/tasks/patch.js';
+import { contactsPatch } from '../services/contacts/patch.js';
 export const patches = {
     gmail: gmailPatch,
     calendar: calendarPatch,
@@ -17,5 +18,6 @@ export const patches = {
     meet: meetPatch,
     sheets: sheetsPatch,
     tasks: tasksPatch,
+    contacts: contactsPatch,
 };
 //# sourceMappingURL=patches.js.map

package/build/factory/patches.js.map

@@ -1 +1 @@
-{"version":3,"file":"patches.js","sourceRoot":"","sources":["../../src/factory/patches.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAGxD,MAAM,CAAC,MAAM,OAAO,GAAiC;IACnD,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE,aAAa;IACvB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,UAAU;CAClB,CAAC"}
+{"version":3,"file":"patches.js","sourceRoot":"","sources":["../../src/factory/patches.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAG9D,MAAM,CAAC,MAAM,OAAO,GAAiC;IACnD,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE,aAAa;IACvB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE,aAAa;CACxB,CAAC"}

package/build/factory/safety.js

@@ -58,6 +58,10 @@ export const noDelete = {
             tasks: ['delete', 'deleteTaskList'],
             docs: [],
             sheets: [],
+            // Keyed by google_service, so contacts is `people`. An operator who turned this
+            // policy on asked for no permanent deletion; whether Google's own trash would have
+            // caught the contact is not the question they asked.
+            people: ['delete'],
         };
         const blocked = permanentDeletes[service] ?? [];
         if (blocked.includes(ctx.operation)) {

package/build/factory/safety.js.map

@@ -1 +1 @@
-{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../src/factory/safety.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../src/factory/safety.ts"],"names":[],"mappings":"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"}

package/build/google/descriptor.d.ts

@@ -2,6 +2,8 @@ export interface ApiParam {
     location: 'path' | 'query';
     required?: boolean;
     repeated?: boolean;
+    /** The values Google accepts, when it constrains them. Calendar declares its enums here. */
+    enum?: string[];
 }
 export interface ApiMediaUpload {
     maxSize?: string;
@@ -25,6 +27,12 @@ export interface ApiService {
     /** `fields`, `alt`, `quotaUser`… declared once at the document root, not per method. */
     globalParameters: Record<string, ApiParam>;
     methods: Record<string, ApiMethod>;
+    /**
+     * Enum values from Discovery's schema properties, keyed `SchemaName.field` —
+     * e.g. `SpaceConfig.moderation`. This is where REQUEST-BODY enums live, which method
+     * parameters cannot express.
+     */
+    enums: Record<string, string[]>;
 }
 export interface ApiDescriptor {
     generatedFrom: string;

package/build/google/descriptor.js

@@ -8,8 +8,15 @@
  *
  * It records what Discovery says about how to CALL Google. It records nothing
  * about what a RESPONSE means — Discovery's `schemas` block (~90% of the raw
- * document) is deliberately DISCARDED. A descriptor that knows response shapes is
- * a descriptor that can start helpfully reshaping them.
+ * document) is discarded, with ONE exception. A descriptor that knows response
+ * shapes is a descriptor that can start helpfully reshaping them.
+ *
+ * The exception is enum VALUES, taken from schema properties and method parameters
+ * alike (`enums` below, and `ApiParam.enum`). They describe what may go into a
+ * request, not what comes back, so they do not open the reshaping door. Without
+ * them a handler that builds a request body is checked by nothing here: a handler
+ * sending `MODERATION_ON` where Google wanted `ON` passed lint, type-check and the
+ * whole suite, and was found only by calling Google.
  *
  * See ADR-103.
  */

package/build/google/descriptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"descriptor.js","sourceRoot":"","sources":["../../src/google/descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAuCzC,IAAI,MAAiC,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC;IACtE,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,SAAS,CAAC;AACrB,CAAC"}
+{"version":3,"file":"descriptor.js","sourceRoot":"","sources":["../../src/google/descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA+CzC,IAAI,MAAiC,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC;IACtE,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,SAAS,CAAC;AACrB,CAAC"}