MCP Tools Reference: gmailmcp.googleapis.com

도구: label_message

인증된 사용자의 Gmail 계정에 있는 특정 메시지에 하나 이상의 라벨을 추가합니다.

메시지 ID를 찾으려면 search_threads 또는 get_thread와 같은 도구를 사용합니다. 사용자 라벨의 ID를 잘 모르는 경우 먼저 list_labels 도구를 사용하여 사용 가능한 라벨과 ID를 확인합니다. 메시지에 휴지통 라벨 또는 스팸 라벨을 추가하려면 apply_sensitive_message_label 도구를 대신 사용하세요.

다음 샘플에서는 curl을 사용하여 label_message MCP 도구를 호출하는 방법을 보여줍니다.

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

입력 스키마

LabelMessage RPC의 요청 메시지입니다.

LabelMessageRequest

JSON 표현 
{
  "messageId": string,
  "labelIds": [
    string
  ]
}
필드
messageId

string

필수 항목입니다. 라벨을 추가할 메시지의 ID입니다.
labelIds[]

string

필수 항목입니다. 추가할 라벨의 ID입니다. 시스템 라벨 ID (예: 'INBOX', 'STARRED', 'UNREAD', 'IMPORTANT') 또는 사용자 정의 라벨 ID일 수 있습니다. 이 도구는 라벨 이름이 아닌 label_ids를 허용합니다. list_labels 도구를 사용하여 사용자 정의 라벨의 표시 이름에 해당하는 라벨 ID를 가져옵니다.

출력 스키마

LabelMessage RPC의 응답 메시지입니다.

도구 주석

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ❌ | 개방형 세계 힌트: ❌

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify