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. Thao tác này sẽ trả về mã nhận dạng của thư nháp đã tạo trong Gmail. 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. Tính năng tạo bản nháp có tệp đính kèm chưa được hỗ trợ.

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

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

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
}
Trường
to[]

string

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 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".
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 thư 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 và body cũng như html_body sẽ được thêm vào nội dung thư gốc.

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
}
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).

Chú giải công cụ

Gợi ý phá huỷ: ❌ | Gợi ý không thay đổi giá trị: ❌ | Gợi ý chỉ đọc: ❌ | Gợi ý thế giới mở: ❌