MCP Tools Reference: gmailmcp.googleapis.com

Alat: label_thread

Menambahkan label ke seluruh percakapan di akun Gmail pengguna terautentikasi. Operasi ini memengaruhi semua pesan yang saat ini ada dalam percakapan dan pesan mendatang yang ditambahkan ke percakapan tersebut.

Jika tidak yakin dengan ID percakapan, gunakan alat search_threads terlebih dahulu.

Jika tidak yakin dengan ID label pengguna, gunakan alat list_labels terlebih dahulu untuk menemukan label yang tersedia dan ID-nya. Untuk menambahkan label sampah atau label spam ke percakapan, gunakan alat apply_sensitive_thread_label.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP label_thread.

Permintaan 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": "label_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Pesan permintaan untuk LabelThread RPC.

LabelThreadRequest

Representasi JSON 
{
  "threadId": string,
  "labelIds": [
    string
  ]
}
Kolom
threadId

string

Wajib. ID unik percakapan yang akan ditambahkan label.
labelIds[]

string

Wajib. ID unik label yang akan ditambahkan. Dapat berupa ID label sistem (misalnya, 'INBOX', 'STARRED', 'UNREAD', 'IMPORTANT') atau ID label yang ditentukan pengguna. Alat ini menerima label_ids, bukan nama label. Gunakan alat list_labels untuk mendapatkan ID label yang sesuai dengan nama tampilan untuk label yang ditentukan pengguna.

Skema Output

Pesan respons untuk LabelThread RPC.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ❌

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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