MCP Tools Reference: drivemcp.googleapis.com

Tool: get_file_permissions

Call this tool to list the permissions of a Drive File.

The following sample demonstrate how to use curl to invoke the get_file_permissions MCP tool.

Curl Request 
curl --location 'https://drivemcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_file_permissions",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Input Schema

Request to get file permissions.

GetFilePermissionsRequest

JSON representation 
{
  "fileId": string
}
Fields
fileId

string

Required. The ID of the file to get permissions for.

Output Schema

Response to get file permissions.

GetFilePermissionsResponse

JSON representation 
{
  "permissions": [
    {
      object (Permission)
    }
  ]
}
Fields
permissions[]

object (Permission)

The list of permissions.

Permission

JSON representation 
{

  "role": string

  "displayName": string

  "type": string

  "emailAddress": string

  "view": string
}
Fields

Union field _role.

_role can be only one of the following:
role

string

The role of the grantee for the file. The possible roles include: * owner * organizer * fileOrganizer * writer * commenter * reader

Union field _display_name.

_display_name can be only one of the following:
displayName

string

Output only. The "pretty" name of the value of the permission. The following is a list of examples for each type of permission: * user - User's full name, as defined for their Google Account, such as "Dana A." * group - Name of the Google Group, such as "The Company Administrators." * domain - String domain name, such as "cymbalgroup.com." * anyone - No displayName is present.

Union field _type.

_type can be only one of the following:
type

string

The type of the grantee. Supported values include: * user * group * domain * anyone

Union field _email_address.

_email_address can be only one of the following:
emailAddress

string

The email address of the user or group to which this permission refers.

Union field _view.

_view can be only one of the following:
view

string

Specifies the view to which this permission applies, if any. Supported values include: * published * metadata

Tool Annotations

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌