# Permissions List

Google Drive

List the users, groups, domains, and links that can access a file in a connected Google Drive.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Permissions List (tool ID: google-drive.permissions-list). Ask me for the details you need, then show me the result. Help me connect the required app account if needed.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

This tool also needs you to connect your app account.

Connect your first agent to receive $1 trial credit.

**Job:** [Manage Google Drive files](https://scrollport.com/tools/google-drive-mcp)

**Current price:** $0.0025/request

**Availability:** Requires connected account

## Tool details

**About this tool**

Lists permissions for one Drive file, including user, group, domain, and link roles returned by Google. Billed per upstream request at $0.0025; each response page is one request.

**Inputs and outputs**

### Input

`max_pages` integer · optional

Maximum number of result pages to request.

minimum: 1 · maximum: 10

`path` object · required

Identifier path for the authorised connected-app record.

`query` object · optional

Search terms used to find relevant records.

### Output

`pages` number

Returned pages value.

`results` array

Returned results value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "google-drive.permissions-list",
  "input": {
    "path": {
      "fileId": "YOUR-GOOGLE-DRIVE-FILE-ID"
    },
    "query": {
      "fields": "nextPageToken,permissions(id,type,role,displayName,emailAddress,domain,allowFileDiscovery)",
      "pageSize": 1,
      "supportsAllDrives": true
    },
    "max_pages": 1
  }
}
```

### Output

```
{
  "pages": 1,
  "results": [
    {
      "id": "permission-output-id",
      "role": "owner",
      "type": "user",
      "displayName": "Example User",
      "emailAddress": "user@example.com"
    }
  ]
}
```

**Errors and limitations**

- `connection_required`: This capability acts on your own Google Drive, which isn't connected yet.Open connect_url, approve Google Drive read and write access, then retry this run unchanged.

---

Canonical page: https://scrollport.com/tools/providers/google-drive/permissions-list