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. Hàm này trả về mã nhận dạng của thư nháp đã tạo trong Gmail.

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' \
--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 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
}
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 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 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 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.

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