MCP Tools Reference: gmailmcp.googleapis.com

도구: get_thread

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

선택사항인 messageFormat 매개변수는 반환되는 메시지의 형식을 제어합니다. 기본적으로 (또는 FULL_CONTENT 사용 시) 메시지의 전체 콘텐츠를 반환합니다. MINIMAL를 사용하여 제목과 스니펫만 포함합니다 (본문 제외). METADATA_ONLY를 사용하여 기본 메타데이터 (메시지 ID, 스레드 ID, 라벨, 타임스탬프, 크기 추정치)만 포함합니다.

다음 샘플은 curl를 사용하여 get_thread 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": "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입니다. 참고: MINIMAL 형식은 id, snippet, subject, from, to, cc, date, labelIds를 반환합니다. METADATA_ONLY 형식은 id, from, to, cc, date, labelIds를 반환합니다. FULL_CONTENT는 id, snippet, subject, from, to, cc, date, labelIds, attachmentIds, plaintextBody, htmlBody, attachments를 반환합니다.

MessageFormat

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

열거형
MESSAGE_FORMAT_UNSPECIFIED 기본값은 FULL_CONTENT입니다.
MINIMAL 메일 스니펫과 주요 헤더 (제목, 보낸사람, 받는사람, 참조, 날짜)를 반환합니다.
FULL_CONTENT 'MINIMAL'의 모든 정보와 각 메일의 전체 본문 콘텐츠를 반환합니다.
METADATA_ONLY 메타데이터만: 제목, 스니펫, 본문, 첨부파일 이름은 포함되지 않습니다.

출력 스키마

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

스레드

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
  ],
  "htmlBody": string,
  "attachments": [
    {
      object (AttachmentMetadata)
    }
  ],
  "labelIds": [
    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인 경우에만 채워집니다.
htmlBody

string

이메일의 HTML 콘텐츠입니다. MessageFormat이 FULL_CONTENT인 경우에만 채워집니다.
attachments[]

object (AttachmentMetadata)

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

string

메일에 첨부된 라벨의 ID입니다. 사용자 라벨과 INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT, CHAT로 제한된 표준 시스템 라벨의 ID가 포함됩니다.

AttachmentMetadata

JSON 표현 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
필드
id

string

출력 전용입니다. 첨부파일의 ID입니다.
mimeType

string

첨부파일의 MIME 유형입니다.
filename

string

첨부파일의 파일 이름입니다.

도구 주석

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

승인 범위

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

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