Google Drive

GoogleDrive_SetGeneralAccess

Change the 'General access' (link sharing) setting on a Google Drive file. Idempotent: calling with the same state as the current configuration is a no-op. When access is 'domain', the link is scoped to the caller's email domain -- NOT the file owner's domain. For cross-org collaboration (e.g., editing a file owned by another organization), confirm with the user which domain they intend before calling. Google will reject domain sharing for personal accounts (gmail.com, outlook.com, etc.) -- the tool translates that rejection into a friendly error. The response's `access` and `role` fields report the EFFECTIVE state after the transition, not the requested state. For files on shared drives, inherited link permissions cannot be changed from the file level -- if the request would have required removing an inherited permission, the effective state will reflect the inherited permission that remained. When `skipped_inherited` is non-empty, inspect it to understand why effective state may differ from what was requested.

Remote googledrive

Remote (network-hosted)

Other tools also called GoogleDrive_SetGeneralAccess? See providers with this name

Input Schema


            {
  "type": "object",
  "properties": {
    "role": {
      "enum": [
        "reader",
        "commenter",
        "writer"
      ],
      "type": "string",
      "description": "The role granted via the link when access is 'domain' or 'anyone'. Ignored when access is 'restricted'. Defaults to reader (view-only). Constrained to reader/commenter/writer -- Drive rejects owner and organizer roles on link permissions."
    },
    "access": {
      "enum": [
        "restricted",
        "domain",
        "anyone"
      ],
      "type": "string",
      "description": "The new General access setting. 'restricted' removes link sharing, 'domain' shares with the caller's Google Workspace domain, 'anyone' makes it public with the link. Defaults to 'restricted'."
    },
    "allow_discovery": {
      "type": "boolean",
      "description": "Whether the file should be discoverable through search. Only meaningful when access is 'domain' or 'anyone'. Defaults to False."
    },
    "file_path_or_id": {
      "type": "string",
      "description": "The file path like folder/subfolder/filename or the file ID. If providing a path, it will be resolved within My Drive by default."
    },
    "shared_drive_id": {
      "type": "string",
      "description": "If the file is in a shared drive and using a path, provide the shared drive ID. Not needed when using file IDs. Defaults to None (uses My Drive)."
    }
  }
}