MCP Tools Reference: gmailmcp.googleapis.com

도구: create_draft

인증된 사용자의 Gmail 계정에 새 초안 이메일을 만듭니다.

이 도구는 수신자 주소, 제목, 본문 콘텐츠를 입력으로 사용합니다. 만들어진 Gmail 초안의 ID를 반환합니다. 초안이 기존 메시지에 대한 답장으로 생성된 경우 원본 메시지의 ID가 replyToMessageId 필드의 도구에 전달되어야 합니다. 첨부파일이 있는 초안을 만드는 것은 아직 지원되지 않습니다.

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

입력 스키마

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

CreateDraftRequest

JSON 표현 
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string,
  "replyToMessageId": string
}
필드
to[]

string

필수 항목입니다. 이메일 초안의 기본 수신자입니다. 각 문자열은 유효한 일반 이메일 주소 (예: 'user@example.com')여야 합니다. '이름 email@example.com' 형식은 이 도구에서 지원되지 않습니다.
cc[]

string

선택사항입니다. 이메일 초안의 참조 수신자입니다. 각 문자열은 유효한 일반 이메일 주소 (예: 'user@example.com')여야 합니다. '이름 email@example.com' 형식은 이 도구에서 지원되지 않습니다.
bcc[]

string

선택사항입니다. 이메일 초안의 숨은참조 수신자입니다. 각 문자열은 유효한 일반 이메일 주소 (예: 'user@example.com')여야 합니다. '이름 email@example.com' 형식은 이 도구에서 지원되지 않습니다.
subject

string

선택사항입니다. 이메일의 제목입니다. 제공되지 않은 경우 기본값은 비어 있습니다.
body

string

선택사항입니다. 이메일 초안의 기본 본문 콘텐츠입니다. html_body도 제공된 경우 이 필드는 일반 텍스트 대체로 처리됩니다.
htmlBody

string

이메일 초안의 HTML 콘텐츠입니다. 제공된 경우 이메일의 서식 있는 텍스트 버전으로 사용됩니다.
replyToMessageId

string

선택사항입니다. 답장할 메시지의 ID입니다. 제공된 경우 이메일 초안의 답장 메시지 ID로 사용되며 body 및 html_body가 원본 메일 본문에 추가됩니다.

출력 스키마

초안의 세부정보입니다.

초안

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)의 초안 날짜입니다.

도구 주석

파괴적 힌트: ❌ | 멱등성 힌트: ❌ | 읽기 전용 힌트: ❌ | 개방형 세계 힌트: ❌