well_create_drive_folder_share

io.github.WellApp-ai/well-mcp · Verify this server

Share one client project folder in Google Drive with one person. The person confirms on a card first; the card shows the folder, the address and the access, so pass the address the person named, exactly. Only a project folder well_create_project_folder made can be shared, never Well's own folder. Pass `folder_id` and `folder_name` as it returned them, the `email`, and `role`: "reader" (the default: the person opens and downloads) unless the person asks that the client can edit ("writer"). Well reads the folder's permissions first: a person who already has that access gets nothing new, and an access is never lowered. Google sends no email of its own (`notify` false): put `folder.web_view_link` in the message you draft for the client. Returns `outcome`: "shared", "role_updated", "already_shared" (with `existing_role`), or a refusal with nothing shared: "notify_required" (Google shares with this address only if Google emails the person: ask, and on a yes call again with `notify: true`), "folder_not_found", "folder_name_mismatch" (`folder.name` is the current name), "not_a_project_folder", "not_connected", "connection_choice_needed" (with `connection_ids`), "needs_reconnect", "no_root_folder", "failed". A shortcut in the folder opens only for people who already have access to its original file. `targets_not_shared` lists those originals: `access` "not_shared" (the person cannot open it) or "unknown" (Well cannot read its sharing). Tell the person which files the client may not be able to open; Well does not share the originals. If `targets_check` is "partial", Well checked only some of the originals; if it is "unavailable", Well could not check any. The folder is shared either way: say so, and do not tell the person the originals are fine. When the token authorizes one workspace, call this directly — no workspace call is needed first. When it authorizes several, this read will not guess which one you mean: pass `workspace_id` on the call.