MCP Tools Reference: gmailmcp.googleapis.com

Công cụ: create_draft

Tạo một thư nháp mới trong tài khoản Gmail của người dùng đã xác thực.

Công cụ này lấy địa chỉ người nhận, tiêu đề và nội dung thư làm dữ liệu đầu vào. Nếu thư nháp được tạo dưới dạng thư trả lời cho một thư hiện có, thì mã nhận dạng của thư gốc phải được truyền đến công cụ trong trường replyToMessageId.

Chỉ trả về mã nhận dạng duy nhất (id) của thư nháp.

Hạn chế: Hiện tại, bạn chưa thể tạo bản nháp có tệp đính kèm.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ MCP create_draft.

Yêu cầu 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
}'

Giản đồ đầu vào

Thông báo yêu cầu cho RPC CreateDraft.

CreateDraftRequest

Biểu diễn dưới dạng JSON 
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string,
  "replyToMessageId": string,
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
Trường
to[]

string

Không bắt buộc. Người nhận chính của bản nháp email. Mỗi chuỗi PHẢI là một địa chỉ email thuần tuý hợp lệ (ví dụ: "user@example.com"). Công cụ này KHÔNG hỗ trợ định dạng "Tên email@example.com".
cc[]

string

Không bắt buộc. Những người nhận bản sao của email nháp. Mỗi chuỗi PHẢI là một địa chỉ email thuần tuý hợp lệ (ví dụ: "user@example.com"). Công cụ này KHÔNG hỗ trợ định dạng "Tên email@example.com".
bcc[]

string

Không bắt buộc. Người nhận được gửi bản sao ẩn của bản nháp email. Mỗi chuỗi PHẢI là một địa chỉ email thuần tuý hợp lệ (ví dụ: "user@example.com"). Công cụ này KHÔNG hỗ trợ định dạng "Tên email@example.com".
subject

string

Không bắt buộc. Dòng tiêu đề của email. Giá trị mặc định là trống nếu không được cung cấp.
body

string

Không bắt buộc. Nội dung chính của bản nháp email. Nếu bạn cũng cung cấp html_body, thì trường này sẽ được coi là văn bản thay thế thuần tuý.
htmlBody

string

Nội dung HTML của email nháp. Nếu được cung cấp, giá trị này sẽ được dùng làm phiên bản văn bản đa dạng thức của email.
replyToMessageId

string

Không bắt buộc. Mã nhận dạng của tin nhắn cần trả lời. Nếu được cung cấp, mã này sẽ được dùng làm mã nhận dạng thư trả lời cho bản nháp email, đồng thời body và html_body sẽ được thêm vào nội dung thư gốc.
attachments[]

object (Attachment)

Không bắt buộc. Các tệp đính kèm cần có trong email. Tổng kích thước của các tệp đính kèm trong thư không được vượt quá 25 MB. Nếu cần gửi tệp lớn hơn 25 MB, trước tiên, hãy tải tệp đó lên Drive rồi chèn đường liên kết đến tệp đó vào phần nội dung hoặc html_body.

Tệp đính kèm

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "filename": string,
  "mimeType": string,
  "content": string,
  "inline": boolean
}
Trường
id

string

Không bắt buộc. Chỉ có đầu ra. Khi có, chứa mã nhận dạng của một tệp đính kèm bên ngoài có thể được truy xuất trong một yêu cầu GetMessageAttachment riêng biệt.
filename

string

Không bắt buộc. Tên của tệp cần đính kèm, ví dụ: "invoice.pdf". Đối với tệp đính kèm nội tuyến, tham số này được dùng để tạo Content-ID. Đối với tệp đính kèm thông thường, tên tệp được dùng để chỉ định tên tệp cho ứng dụng email. Nếu không được cung cấp, tệp đính kèm có thể được nhận mà không có tên.
mimeType

string

Không bắt buộc. Trường đại diện cho một loại nội dung hoặc nội dung nghe nhìn phải sử dụng loại MIME của IANA, https://www.iana.org/assignments/media-types/media-types.xhtml. Nếu bạn không cung cấp, giá trị mặc định sẽ là "application/octet-stream".
content

string (bytes format)

Bắt buộc. Nội dung được mã hoá base64 của tệp đính kèm.

Một chuỗi được mã hoá base64.
inline

boolean

Không bắt buộc. Nếu đúng, tệp đính kèm này sẽ được xử lý dưới dạng nội tuyến. Tệp đính kèm nội dòng là nội dung được hiển thị trong phần nội dung của email HTML, thay vì được liệt kê dưới dạng một tệp riêng để tải xuống. Nếu là false hoặc không có, thì giá trị mặc định là false và tệp này được coi là tệp đính kèm thông thường.

Giản đồ đầu ra

Thông tin chi tiết về bản nháp.

Bản nháp

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string,
  "htmlBody": string
}
Trường
id

string

Giá trị nhận dạng duy nhất của tài nguyên nháp.
subject

string

Dòng tiêu đề của thư nháp.
threadId

string

Mã của chuỗi mà bản nháp này thuộc về.
toRecipients[]

string

Danh sách địa chỉ email của người nhận trong trường "Đến" được trích xuất từ phần đầu thư.
ccRecipients[]

string

Danh sách địa chỉ email của người nhận "Cc" được trích xuất từ phần đầu thư.
bccRecipients[]

string

Danh sách địa chỉ email của người nhận "Bcc" được trích xuất từ phần đầu thư.
plaintextBody

string

Nội dung văn bản thuần tuý (nếu có).
date

string

Ngày của bản nháp ở định dạng ISO 8601 (YYYY-MM-DD).
htmlBody

string

Nội dung phần thân HTML của bản nháp (nếu có).

Chú giải công cụ

Gợi ý mang tính huỷ diệt: ❌ | Gợi ý mang tính luỹ đẳng: ❌ | Gợi ý chỉ đọc: ❌ | Gợi ý về thế giới mở: ❌

Phạm vi cấp phép

Yêu cầu một trong các phạm vi OAuth sau:

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