MCP Tools Reference: gmailmcp.googleapis.com

Ferramenta: list_drafts

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

Essa ferramenta pode filtrar rascunhos com base em uma string de consulta e é compatível com paginação. Ela retorna uma lista de rascunhos, incluindo IDs e assuntos.

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

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

Esquema de entrada

Mensagem de solicitação para a RPC ListDrafts.

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.

Campo de união _query.

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

string

Opcional. Uma string de consulta para filtrar os rascunhos, usando o mesmo formato da barra de pesquisa no Gmail. Se omitido, todos os rascunhos (exceto spam e lixeira por padrão) serão listados. Operadores principais: de: - Mensagens de um remetente específico. to: - Mensagens enviadas para um destinatário específico. subject: - Mensagens com palavras específicas no assunto. - Mensagens que contêm palavras específicas no corpo ou no assunto. is:unread - Mensagens não lidas. is:starred - Mensagens com estrela. has:attachment - Mensagens com anexos. after:AAAA/MM/DD: mensagens enviadas após uma data. before:AAAA/MM/DD: mensagens enviadas antes de uma data. newer_than:

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

Esquema de saída

Mensagem de resposta para a RPC ListDrafts.

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. Presente apenas se houver mais resultados.

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 em rascunho.
threadId

string

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

string

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

string

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

string

Lista de endereços de e-mail de destinatários em "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 de ferramentas

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