MCP Tools Reference: gmailmcp.googleapis.com

도구: create_draft

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

이 도구는 수신자 주소, 제목, 본문 콘텐츠를 입력으로 사용합니다. 초안이 기존 메일에 대한 답장으로 생성된 경우 원본 메일의 ID가 replyToMessageId 필드에서 도구로 전달되어야 합니다.

초안 메일의 고유 ID (id)만 반환합니다.

제한사항: 첨부파일이 있는 초안 만들기는 아직 지원되지 않습니다.

다음 샘플은 curl를 사용하여 create_draft 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": "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,
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
필드
to[]

string

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

string

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

string

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

string

선택사항입니다. 이메일의 제목입니다. 제공되지 않으면 기본적으로 빈 값으로 설정됩니다.
body

string

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

string

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

string

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

object (Attachment)

선택사항입니다. 이메일에 포함할 첨부파일입니다. 메일의 첨부파일을 합한 크기는 25MB를 초과할 수 없습니다. 25MB보다 큰 파일을 보내야 하는 경우 먼저 파일을 Drive에 업로드한 다음 Drive 링크를 본문 또는 html_body에 삽입하세요.

첨부파일

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

string

선택사항입니다. 출력 전용입니다. 있는 경우 별도의 GetMessageAttachment 요청에서 가져올 수 있는 외부 첨부파일의 ID를 포함합니다.
filename

string

선택사항입니다. 첨부할 파일의 이름입니다(예: 'invoice.pdf'). 인라인 첨부 파일의 경우 Content-ID 생성에 사용됩니다. 일반 첨부파일의 경우 파일 이름은 이메일 클라이언트에 파일 이름을 지정하는 데 사용됩니다. 제공되지 않으면 첨부파일이 이름 없이 수신될 수 있습니다.
mimeType

string

선택사항입니다. 콘텐츠 또는 미디어 유형을 나타내는 필드는 IANA MIME 유형(https://www.iana.org/assignments/media-types/media-types.xhtml)을 사용해야 합니다. 제공되지 않으면 기본값은 'application/octet-stream'입니다.
content

string (bytes format)

필수 항목입니다. 첨부파일의 base64로 인코딩된 콘텐츠입니다.

base64 인코딩 문자열입니다.
inline

boolean

선택사항입니다. true인 경우 이 첨부파일은 인라인으로 처리됩니다. 인라인 첨부파일은 다운로드용 별도 파일로 나열되는 것이 아니라 HTML 이메일 본문 내에 표시되도록 설계된 콘텐츠입니다. false이거나 없는 경우 기본값은 false이며 일반 첨부파일로 처리됩니다.

출력 스키마

초안의 세부정보입니다.

초안

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