List comments
list_commentsRetrieve all comment threads in a Google Doc, including replies, resolution status, author, timestamps, and quoted text. Paginate through large sets, and optionally include deleted comments.
Instructions
Lists the document's comment threads via the Drive API: for each comment its id, content, author displayName, createdTime/modifiedTime, resolved flag, the quoted document text it anchors to (quotedFileContent) and its replies (with their action: resolve/reopen). Paginate with page_token; include_deleted=true also returns deleted comments as tombstones. Requires a Drive scope on the OAuth token (comments are Drive data, not Docs API data). Comment ids feed manage_comment.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"document_id": "<document_id>"
},
"name": "list_comments"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page_size | No | Comments per page (default 20, max 100). | |
| page_token | No | Continuation token from the previous page. | |
| document_id | Yes | The document id — the long id from the document URL (docs.google.com/document/d/<documentId>/edit) or from create_document output. | |
| include_deleted | No | Also return deleted comments (default false). |