MCP Tools Reference: gmailmcp.googleapis.com

Narzędzie: search_threads

Wyświetla wątki e-maili z konta Gmail uwierzytelnionego użytkownika.

To narzędzie może filtrować wątki na podstawie ciągu zapytania i obsługuje paginację. Zwraca listę wątków, w tym ich identyfikatory i powiązane wiadomości. Każda powiązana wiadomość zawiera szczegóły, takie jak fragment treści wiadomości, temat, nadawca, odbiorcy itp. Pamiętaj, że to narzędzie nie zwraca pełnej treści wiadomości. Jeśli jest to potrzebne, użyj narzędzia „get_thread” z identyfikatorem wątku, aby pobrać pełną treść wiadomości.

Poniższy przykład pokazuje, jak za pomocą znaku curl wywołać narzędzie search_threads MCP.

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

Schemat wejściowy

Wiadomość z prośbą o wywołanie RPC SearchThreads.

SearchThreadsRequest

Zapis JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
Pola

Pole zbiorcze _page_size.

Pole _page_size może mieć tylko jedną z tych wartości:
pageSize

integer

Opcjonalnie. Maksymalna liczba wątków do zwrócenia. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość 20. Maksymalna dozwolona wartość to 50.

Pole zbiorcze _page_token.

Pole _page_token może mieć tylko jedną z tych wartości:
pageToken

string

Opcjonalnie. Token strony umożliwiający pobranie konkretnej strony wyników na liście. Aby pobrać pierwszą stronę, pozostaw to pole puste.

Pole zbiorcze _query.

Pole _query może mieć tylko jedną z tych wartości:
query

string

Opcjonalnie. Ciąg zapytania do filtrowania wątków w tym samym formacie co na pasku wyszukiwania w Gmailu. Jeśli ten parametr zostanie pominięty, wyświetlone zostaną wszystkie wątki (z wyjątkiem spamu i kosza). Kluczowe operatory: from: – wiadomości od określonego nadawcy. do: – wiadomości wysłane do określonego odbiorcy. subject: – wiadomości zawierające określone słowa w temacie. - Wiadomości zawierające określone słowa w treści lub temacie. is:unread - Nieprzeczytane wiadomości. is:starred - Wiadomości oznaczone gwiazdką. has:attachment - Wiadomości z załącznikami. after:RRRR/MM/DD – wiadomości wysłane po określonej dacie. before:RRRR/MM/DD – wiadomości wysłane przed określoną datą. newer_than: „” – wyszukaj dokładną frazę.

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

Pole zbiorcze _include_trash.

Pole _include_trash może mieć tylko jedną z tych wartości:
includeTrash

boolean

Opcjonalnie. Uwzględnij w wynikach wersje robocze z KOSZA. Wartość domyślna to fałsz.

Schemat wyjściowy

Wiadomość z odpowiedzią dla RPC SearchThreads.

SearchThreadsResponse

Zapis JSON 
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string
}
Pola
threads[]

object (Thread)

Lista podsumowań wątków.
nextPageToken

string

Token, którego można użyć w kolejnym wywołaniu, aby pobrać następną stronę wątków. Wyświetlany tylko wtedy, gdy jest więcej wyników.

Wątek

Zapis JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Pola
id

string

Unikalny identyfikator wątku.
messages[]

object (Message)

Lista wiadomości w wątku, uporządkowana chronologicznie.

Wiadomość

Zapis JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string
}
Pola
id

string

Unikalny identyfikator wiadomości.
snippet

string

Fragment treści wiadomości.
subject

string

Temat wiadomości wyodrębniony z nagłówków:
sender

string

Adres e-mail nadawcy.
toRecipients[]

string

Adresy e-mail odbiorców.
ccRecipients[]

string

Adresy e-mail odbiorców w polu DW.
date

string

Data wiadomości w formacie ISO 8601 (RRRR-MM-DD).
plaintextBody

string

Pełna treść, wypełniana tylko wtedy, gdy MessageFormat ma wartość FULL_CONTENT.

Adnotacje narzędzi

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌