MCP Tools Reference: gmailmcp.googleapis.com

도구: get_thread

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

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

curl 요청 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--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's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

GetThread RPC 요청 메시지입니다.

GetThreadRequest

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

string

필수 항목입니다. 가져올 스레드의 고유 식별자입니다.
messageFormat

enum (MessageFormat)

선택사항입니다. 스레드 내에서 반환되는 메시지의 형식을 지정합니다. 기본값은 FULL_CONTENT입니다. 참고: 본문 콘텐츠나 첨부 파일이 필요한 경우 FULL_CONTENT를 사용하세요. MINIMAL을 사용하면 plaintext_body 및 attachment_ids 필드가 채워지지 않습니다. 어떤 형식을 사용해야 할지 잘 모르겠다면 FULL_CONTENT를 사용하여 기본 동작을 따르세요.

MessageFormat

스레드의 메시지에 대한 세부정보 수준을 제어하는 열거형입니다.

열거형
MESSAGE_FORMAT_UNSPECIFIED 기본값은 FULL_CONTENT입니다.
MINIMAL 메일 스니펫과 주요 헤더 (제목, 보낸사람, 받는사람, 참조, 날짜)를 반환합니다.
FULL_CONTENT 'MINIMAL'의 모든 정보와 각 메일의 전체 본문 콘텐츠를 반환합니다.

출력 스키마

메시지 목록이 포함된 스레드

스레드

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,
  "attachmentIds": [
    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인 경우에만 채워집니다.
attachmentIds[]

string

출력 전용입니다. 첨부파일 ID입니다. MessageFormat이 FULL_CONTENT인 경우에만 채워집니다.

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌