MCP Tools Reference: gmailmcp.googleapis.com

Ferramenta: list_drafts

Lista os e-mails de rascunho da conta do Gmail do usuário autenticado.

Essa ferramenta pode filtrar rascunhos com base em uma string de consulta e oferece suporte à paginação. Ela retorna uma lista de rascunhos, incluindo os IDs e assuntos. O page_token pode ser usado para paginar os resultados. Para recuperar as páginas de resultados subsequentes, use o page_token retornado na resposta anterior.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta MCP list_drafts.

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

Esquema de entrada

Mensagem de solicitação para ListDrafts RPC.

ListDraftsRequest

Representação JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string
}
Campos

Campo de união _page_size.

_page_size pode ser apenas de um dos tipos a seguir:
pageSize

integer

Opcional. O número máximo de rascunhos a serem retornados. Se não for especificado, o padrão será 20. O valor máximo permitido é 50.

Campo de união _page_token.

_page_token pode ser apenas de um dos tipos a seguir:
pageToken

string

Opcional. Um token recebido de uma chamada list_drafts anterior para recuperar a próxima página de resultados. Deixe em branco para buscar a primeira página. Isso é usado principalmente para paginação, para continuar buscando resultados de onde a chamada ListDraft anterior parou, especialmente quando o número de rascunhos que correspondem à consulta excede o limite de page_size.

Campo de união _query.

_query pode ser apenas de um dos tipos a seguir:
query

string

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

Um espaço ou um traço (-) vai separar um número, e um ponto (.) vai indicar uma casa decimal. Por exemplo, 01.2047-100 é considerado dois números: 01.2047 e 100.

Observação: se quisermos garantir que todos os rascunhos da consulta sejam retornados, podemos paginar os resultados fazendo chamadas repetidas para a ferramenta até que a resposta contenha uma lista vazia de rascunhos.

Esquema de saída

Mensagem de resposta para ListDrafts RPC.

ListDraftsResponse

Representação JSON 
{
  "drafts": [
    {
      object (Draft)
    }
  ],
  "nextPageToken": string
}
Campos
drafts[]

object (Draft)

Lista de rascunhos.
nextPageToken

string

Um token que pode ser usado em uma chamada subsequente para recuperar a próxima página de rascunhos. Se o número de rascunhos que correspondem à consulta exceder o limite de page_size, a resposta vai conter um next_page_token. Para recuperar a próxima página de resultados, transmita esse token no campo page_token da próxima ListDraftsRequest.

Rascunho

Representação JSON 
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string
}
Campos
id

string

O identificador exclusivo do recurso de rascunho.
subject

string

A linha de assunto da mensagem de rascunho.
threadId

string

O ID da conversa a que esse rascunho pertence.
toRecipients[]

string

Lista de endereços de e-mail de destinatários "Para" extraídos dos cabeçalhos.
ccRecipients[]

string

Lista de endereços de e-mail de destinatários "Cc" extraídos dos cabeçalhos.
bccRecipients[]

string

Lista de endereços de e-mail de destinatários "Cco" extraídos dos cabeçalhos.
plaintextBody

string

Conteúdo do corpo de texto simples, se disponível.
date

string

Data do rascunho no formato ISO 8601 (AAAA-MM-DD).

Anotações da ferramenta

Dica destrutiva: ❌ | Dica idempotente: ❌ | Dica somente leitura: ❌ | Dica de mundo aberto: ❌