MCP Tools Reference: gmailmcp.googleapis.com

Araç: search_threads

Kimliği doğrulanmış kullanıcının Gmail hesabındaki e-posta yazışmalarını listeler.

Bu araç, ileti dizilerini sorgu dizesine göre filtreleyebilir ve sayfalara ayırmayı destekler. Kimlikleri ve ilgili iletileri de içeren bir ileti dizisi listesi döndürür. İlgili her iletide, e-posta mesajının snippet'i, konu, gönderen, alıcılar vb. gibi ayrıntılar yer alır. Bu araç, e-posta mesajlarının tamamını döndürmez. Gerekirse e-posta mesajının tamamını getirmek için ileti kimliğiyle birlikte "get_thread" aracını kullanın.

Aşağıdaki örnekte, curl kullanılarak search_threads MCP aracının nasıl çağrılacağı gösterilmektedir.

Curl İsteği 
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": "search_threads",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

SearchThreads RPC için istek mesajı.

SearchThreadsRequest

JSON gösterimi 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
Alanlar

_page_size birleşik alanı.

_page_size aşağıdakilerden yalnızca biri olabilir:
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum ileti dizisi sayısı. Belirtilmemişse varsayılan olarak 20 olur. İzin verilen en yüksek değer 50'dir.

_page_token birleşik alanı.

_page_token aşağıdakilerden yalnızca biri olabilir:
pageToken

string

İsteğe bağlı. Listedeki belirli bir sonuç sayfasını almak için kullanılan sayfa jetonu. İlk sayfayı getirmek için boş bırakın.

_query birleşik alanı.

_query aşağıdakilerden yalnızca biri olabilir:
query

string

İsteğe bağlı. Gmail arama çubuğuyla aynı biçimde, ileti dizilerini filtrelemek için kullanılan bir sorgu dizesi. Atlanırsa tüm ileti dizileri (varsayılan olarak spam ve çöp kutusu hariç) listelenir. Temel operatörler: from: - Belirli bir gönderenden gelen mesajlar. to: - Belirli bir alıcıya gönderilen iletiler. subject: - Konusunda belirli kelimeler geçen iletiler. - Gövde veya konuda belirli kelimeler içeren iletiler. is:unread - Okunmamış iletiler. is:starred - Yıldızlı iletiler. has:attachment - Ek içeren iletiler. after:YYYY/AA/GG: Belirli bir tarihten sonra gönderilen iletiler. before:YYYY/AA/GG: Belirli bir tarihten önce gönderilen iletiler. newer_than:

 Examples:
 "subject:OneMCP Update"
 "from:gduser1@workspacesamples.dev"
 "to:gduser2@workspacesamples.dev AND newer_than:7d"
 "project proposal has:attachment"
 "is:unread"

_include_trash birleşik alanı.

_include_trash aşağıdakilerden yalnızca biri olabilir:
includeTrash

boolean

İsteğe bağlı. ÇÖP KUTUSU'ndaki taslakları sonuçlara dahil et. Varsayılan olarak false değerine ayarlanır.

Çıkış şeması

SearchThreads RPC'si için yanıt mesajı.

SearchThreadsResponse

JSON gösterimi 
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string
}
Alanlar
threads[]

object (Thread)

Mesaj dizisi özetlerinin listesi.
nextPageToken

string

Bir sonraki ileti dizisi sayfasını almak için sonraki bir çağrıda kullanılabilecek jeton. Yalnızca daha fazla sonuç varsa gösterilir.

İplik

JSON gösterimi 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Alanlar
id

string

İş parçacığının benzersiz tanımlayıcısı.
messages[]

object (Message)

İleti dizisindeki mesajların kronolojik olarak sıralanmış listesi.

Mesaj

JSON gösterimi 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string
}
Alanlar
id

string

Mesajın benzersiz tanımlayıcısı.
snippet

string

E-posta mesajının snippet'i.
subject

string

Üstbilgilerden çıkarılan ileti konusu:
sender

string

Gönderenin e-posta adresi.
toRecipients[]

string

Alıcı e-posta adreslerine
ccRecipients[]

string

CC alıcılarının e-posta adresleri.
date

string

İletinin ISO 8601 biçimindeki tarihi (YYYY-AA-GG).
plaintextBody

string

İletinin tam içeriği. Yalnızca MessageFormat FULL_CONTENT ise doldurulur.

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌