MCP Tools Reference: gmailmcp.googleapis.com

도구: get_message

인증된 사용자의 Gmail 계정에서 고유한 메시지 ID로 특정 이메일 메시지를 가져옵니다.

이 도구를 사용하면 메시지 ID를 이미 알고 있는 경우 단일 이메일을 검사할 수 있습니다. 사용자가 특정 이메일을 자세히 읽거나, 메시지의 정확한 문구를 확인하거나, 단일 이메일의 첨부파일 메타데이터를 검사하려는 경우 이 도구를 사용하면 됩니다. 전체 대화목록을 가져오거나 오가는 토론 대화목록을 보는 데는 적합하지 않습니다. 대신 'get_thread' 도구를 사용하세요. 사용자가 이전 검색에서 반환된 특정 메시지 ID의 전체 콘텐츠를 요청하는지 또는 쿼리에서 전체 대화목록이 아닌 특정 개별 이메일을 검사하도록 요청하는지 여부가 주요 지표입니다. 사용자 프롬프트의 예는 '메시지 ID 18f123456789abcd의 전체 텍스트 가져와', '앨리스의 대화목록에서 최신 메시지 읽어 줘', '방금 인사팀에서 받은 이메일의 첨부파일 이름은 뭐야?'입니다.

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

다음 샘플에서는 curl을 사용하여 get_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": "get_message",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

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

GetMessageRequest

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

string

필수 항목입니다. 가져올 메시지의 고유 식별자입니다.
messageFormat

enum (MessageFormat)

선택사항입니다. 반환되는 메시지의 형식을 지정합니다. 기본값은 FULL_CONTENT입니다.

MessageFormat

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

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

출력 스키마

대화목록 내 메시지입니다.

메시지

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