MCP Tools Reference: gmailmcp.googleapis.com

Tool: `unlabel_thread`

Removes labels from an entire thread in the authenticated user's Gmail account. If unsure of the thread ID, use the search_threads tool first. If unsure of a user label's ID, use the list_labels tool first.

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

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

Curl Request

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

Input Schema

Request message for UnlabelThread RPC.

UnlabelThreadRequest

JSON representation
{ "threadId" : string , "labelIds" : [ string ] }

Fields

Fields
`threadId`	`string` Required. The unique identifier of the thread to remove labels from.
`labelIds[]`	`string` Required. The unique identifiers of the labels to remove.

threadId

string

Required. The unique identifier of the thread to remove labels from.

labelIds[]

string

Required. The unique identifiers of the labels to remove.

Output Schema

Response message for UnlabelThread RPC.

Tool Annotations

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