# share_drive_file (https://sellersheetai.com/docs/mcp-api/tools/share_drive_file)

> Share a file with one person (email) or a whole domain (domain; email wins if both are passed).

Access: **WRITE** · toolset google_workspace · family null

Drive sends no notification email — tell the person yourself.

## Call it

MCP tool call:

```json
{
  "name": "share_drive_file",
  "arguments": {
    "fileId": "<fileId>",
    "role": "<role>"
  }
}
```

Tool API (early access — contact us):

```bash
curl -X POST https://api.sellersheetai.com/api/v1/tools/share_drive_file \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileId":"<fileId>","role":"<role>"}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `fileId` | string | yes | the Drive file ID. |
| `role` | string | yes | 'reader', 'commenter' or 'writer'. |
| `email` | string |  | Email address to share with (for user sharing). |
| `domain` | string |  | Domain to share with (for domain sharing). |

## Result

- `permissionId` — Permission ID.

## Example

- share_drive_file(fileId="1XYZ...", role="reader", email="user@example.com") share_drive_file(fileId="1XYZ...", role="reader", domain="example.com")