list_threads

Retrieve and organize email threads from your Gmail mailbox, filtering by labels, queries, or spam/trash. Customize results with HTML body inclusion and pagination for efficient thread management.

Instructions

List threads in the user's mailbox

Input Schema

Name	Required	Description
`includeBodyHtml`	No	Whether to include the parsed HTML in the return for each body, excluded by default because they can be excessively large
`includeSpamTrash`	No	Include threads from SPAM and TRASH in the results
`labelIds`	No	Only return threads with labels that match all of the specified label IDs
`maxResults`	No	Maximum number of threads to return
`pageToken`	No	Page token to retrieve a specific page of results
`q`	No	Only return threads matching the specified query

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "includeBodyHtml": {
      "description": "Whether to include the parsed HTML in the return for each body, excluded by default because they can be excessively large",
      "type": "boolean"
    },
    "includeSpamTrash": {
      "description": "Include threads from SPAM and TRASH in the results",
      "type": "boolean"
    },
    "labelIds": {
      "description": "Only return threads with labels that match all of the specified label IDs",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "maxResults": {
      "description": "Maximum number of threads to return",
      "type": "number"
    },
    "pageToken": {
      "description": "Page token to retrieve a specific page of results",
      "type": "string"
    },
    "q": {
      "description": "Only return threads matching the specified query",
      "type": "string"
    }
  },
  "type": "object"
}

Gmail MCP

list_threads

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Gmail MCP

Related Tools