Skip to main content
Glama

List Google Drive items

list_gdrive_items
Read-only

List files and folders inside a Google Drive folder (defaults to My Drive's root), for one account. Items outside the folders you have access to are not returned.

Input Schema

NameRequiredDescriptionDefault
itemIdNoFolder item ID, or omit / "root" for My Drive root
mailboxYesEmail address of the connected Gmail/Google Workspace mailbox to act on. Call list_authorized_mailboxes to see available options.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, destructiveHint=false and openWorldHint=false, so safety is covered. The description adds real behavioral value on top: the default target is My Drive's root, the operation is scoped to a single account, and results are permission-filtered. It omits pagination/result-limit behavior, so it stops short of 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two tight sentences with zero filler; the primary action and its default are front-loaded, and the access caveat follows as a short trailing qualifier.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only list tool with no output schema, the description covers what is listed, the default scope, and the visibility constraint. It would be fully complete with a note on result size/pagination, which matters for folder listing, but nothing is actively misleading.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so both parameters are already fully documented, including the 'root' sentinel for itemId and the list_authorized_mailboxes pointer for mailbox. The description reinforces the root default and the one-account scoping but adds no format or syntax detail beyond the schema. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Specific verb (List) plus resource (files and folders in a Google Drive folder) and explicit scope (one folder, one account, defaulting to My Drive root). It distinguishes itself from write siblings like create_gdrive_folder and delete_gdrive_item, but never mentions search_gdrive_items or list_gdrive_permissions, so the boundary against the closest read siblings must be inferred.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies the use case (enumerate a folder's contents) and reveals the access boundary that 'items outside the folders you have access to are not returned,' which is useful context. However, it gives no explicit when-to-use versus search_gdrive_items for query-driven lookups, nor prerequisites beyond the mailbox being connected.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources