MCP Tools Reference: gmailmcp.googleapis.com

도구: list_drafts

인증된 사용자의 Gmail 계정에서 임시 이메일을 나열합니다.

이 도구는 쿼리 문자열을 기반으로 초안을 필터링할 수 있으며 페이지로 나누기를 지원합니다. ID와 제목을 포함한 초안 목록을 반환합니다 (view이 DRAFT_VIEW_METADATA_ONLY으로 설정되지 않은 경우). page_token을 사용하여 결과를 페이지로 나눌 수 있습니다. 결과의 후속 페이지를 가져오려면 이전 응답에서 반환된 page_token를 사용하세요.

view 매개변수는 응답에 채워지는 필드를 제어합니다. 기본적으로 (또는 DRAFT_VIEW_FULL 사용 시) 전체 콘텐츠를 반환합니다. DRAFT_VIEW_METADATA_ONLY를 사용하여 제목 및 본문과 같은 민감한 콘텐츠를 제외합니다.

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

입력 스키마

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

ListDraftsRequest

JSON 표현 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "view": enum (DraftView)
}
필드

통합 필드 _page_size.

_page_size는 다음 중 하나여야 합니다.
pageSize

integer

선택사항입니다. 반환할 최대 임시보관함 수입니다. 지정하지 않으면 기본값은 20입니다. 허용되는 최댓값은 50입니다.

통합 필드 _page_token.

_page_token는 다음 중 하나여야 합니다.
pageToken

string

선택사항입니다. 결과의 다음 페이지를 가져오기 위해 이전 list_drafts 호출에서 수신된 토큰입니다. 첫 번째 페이지를 가져오려면 비워 둡니다. 이는 주로 페이지로 나누기를 사용하여 이전 ListDraft 호출이 중단된 지점부터 결과를 계속 가져오는 데 사용되며, 특히 쿼리와 일치하는 초안 수가 page_size 한도를 초과하는 경우에 사용됩니다.

통합 필드 _query.

_query는 다음 중 하나여야 합니다.
query

string

예:

  • subject:OneMCP Update
  • from:gduser1@workspacesamples.dev
  • to:gduser2@workspacesamples.dev AND newer_than:7d
  • project proposal has:attachment
  • is:unread

공백이나 대시 (-)를 사용하면 숫자가 분리되며, 점 (.)을 사용하면 소수점이 됩니다. 예를 들어 01.2047-100은 01.2047과 100라는 숫자 두 개로 간주됩니다.

참고: 쿼리의 모든 초안이 반환되도록 하려면 응답에 빈 초안 목록이 포함될 때까지 도구를 반복적으로 호출하여 결과를 페이지로 나눌 수 있습니다.

통합 필드 _view.

_view는 다음 중 하나여야 합니다.
view

enum (DraftView)

선택사항입니다. 초안 목록의 초안에 채워지는 필드를 제어합니다. 기본적으로 (또는 DRAFT_VIEW_FULL 사용 시) 초안 ID, threadID, 받는사람, 참조, 숨은참조, 날짜, 제목, 본문이 있는 전체 콘텐츠를 반환합니다. DRAFT_VIEW_METADATA_ONLY를 사용하여 제목과 본문을 제외합니다.

DraftView

ListDrafts 응답에서 초안에 채워지는 필드를 제어하는 enum입니다.

열거형
DRAFT_VIEW_UNSPECIFIED 이전 버전과의 호환성을 위해 DRAFT_VIEW_FULL에 매핑됩니다.
DRAFT_VIEW_METADATA_ONLY 메타데이터만 해당합니다. subject, plaintext_body, html_body는 포함되지 않습니다.
DRAFT_VIEW_FULL 메타데이터 + UGC (기본 동작)

출력 스키마

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

ListDraftsResponse

JSON 표현 
{
  "drafts": [
    {
      object (Draft)
    }
  ],
  "nextPageToken": string
}
필드
drafts[]

object (Draft)

초안 목록입니다.
nextPageToken

string

후속 호출에서 다음 임시보관함 페이지를 가져오는 데 사용할 수 있는 토큰입니다. 쿼리와 일치하는 초안 수가 page_size 한도를 초과하면 응답에 next_page_token이 포함됩니다. 결과의 다음 페이지를 가져오려면 다음 ListDraftsRequest의 page_token 필드에 이 토큰을 전달하세요.

초안

JSON 표현 
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string,
  "htmlBody": string
}
필드
id

string

초안 리소스의 고유 식별자입니다.
subject

string

초안 메일의 제목입니다.
threadId

string

이 임시보관함이 속한 스레드의 ID입니다.
toRecipients[]

string

헤더에서 추출한 '받는사람' 수신자 이메일 주소 목록입니다.
ccRecipients[]

string

헤더에서 추출된 '참조' 수신자 이메일 주소 목록입니다.
bccRecipients[]

string

헤더에서 추출된 '숨은참조' 수신자 이메일 주소 목록입니다.
plaintextBody

string

일반 텍스트 본문 콘텐츠(있는 경우)
date

string

ISO 8601 형식 (YYYY-MM-DD)의 초안 날짜입니다.
htmlBody

string

사용 가능한 경우, 초안의 HTML 본문 콘텐츠입니다.

도구 주석

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

승인 범위

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

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