MCP Tools Reference: gmailmcp.googleapis.com

도구: list_drafts

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

이 도구는 쿼리 문자열을 기반으로 초안을 필터링할 수 있으며 페이지 나누기를 지원합니다. ID 및 제목을 포함한 초안 목록을 반환합니다.

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

입력 스키마

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

ListDraftsRequest

JSON 표현 
{

  "pageSize": integer

  "pageToken": string

  "query": string
}
필드

통합 필드 _page_size.

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

integer

선택사항입니다. 반환할 초안의 최대 개수입니다. 지정하지 않으면 기본적으로 20입니다. 허용되는 최댓값은 50입니다.

통합 필드 _page_token.

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

string

선택사항입니다. 결과의 다음 페이지를 가져오기 위해 이전 list_drafts 호출에서 수신된 토큰입니다. 첫 번째 페이지를 가져오려면 비워 둡니다.

통합 필드 _query.

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

string

선택사항입니다. Gmail 검색창과 동일한 형식을 사용하여 초안을 필터링하는 쿼리 문자열입니다. 생략하면 모든 초안 (기본적으로 스팸 및 휴지통 제외)이 나열됩니다. 키 연산자: from: - 특정 발신자의 메시지 to: - 특정 수신자에게 전송된 메시지 subject: - 제목에 특정 단어가 포함된 메시지 - 본문 또는 제목에 특정 단어가 포함된 메시지입니다. is:unread - 읽지 않은 메시지입니다. is:starred - 별표표시된 메시지입니다. has:attachment - 첨부파일이 있는 메시지입니다. after:YYYY/MM/DD - 특정 날짜 이후에 전송된 메시지입니다. before:YYYY/MM/DD - 특정 날짜 이전에 전송된 메시지입니다. newer_than:

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

출력 스키마

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

ListDraftsResponse

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

object (Draft)

초안 목록입니다.
nextPageToken

string

후속 호출에서 초안의 다음 페이지를 가져오는 데 사용할 수 있는 토큰입니다. 결과가 더 있는 경우에만 표시됩니다.

초안

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

string

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

string

초안 메시지의 제목입니다.
threadId

string

이 초안이 속한 대화목록의 ID입니다.
toRecipients[]

string

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

string

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

string

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

string

일반 텍스트 본문 콘텐츠(사용 가능한 경우)입니다.
date

string

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

도구 주석

파괴적 힌트: ❌ | 멱등성 힌트: ❌ | 읽기 전용 힌트: ❌ | 오픈 월드 힌트: ❌