MCP Tools Reference: gmailmcp.googleapis.com

도구: get_thread

메시지 목록을 포함하여 인증된 사용자의 Gmail 계정에서 특정 이메일 대화목록을 가져옵니다.

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

curl 요청 
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": "get_thread",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

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

GetThreadRequest

JSON 표현 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
필드
threadId

string

필수 항목입니다. 가져올 대화목록의 고유 식별자입니다.
messageFormat

enum (MessageFormat)

선택사항입니다. 대화목록 내에서 반환되는 메시지의 형식을 지정합니다. 기본값은 FULL_CONTENT입니다.

출력 스키마

메시지 목록이 포함된 대화목록입니다.

대화목록

JSON 표현 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
필드
id

string

대화목록의 고유 식별자입니다.
messages[]

object (Message)

시간순으로 정렬된 대화목록의 메시지 목록입니다.

메시지

JSON 표현 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string
}
필드
id

string

메시지의 고유 식별자입니다.
snippet

string

메시지 본문의 스니펫입니다.
subject

string

헤더에서 추출된 메시지 제목입니다.
sender

string

발신자 이메일 주소입니다.
toRecipients[]

string

받는 사람의 이메일 주소입니다.
ccRecipients[]

string

참조 받는 사람의 이메일 주소입니다.
date

string

ISO 8601 형식 (YYYY-MM-DD)의 메시지 날짜입니다.
plaintextBody

string

전체 본문 콘텐츠로, MessageFormat이 FULL_CONTENT인 경우에만 채워집니다.

도구 주석

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ✅ | 열린 세상 힌트: ❌