MCP Reference: gmailmcp.googleapis.com

Um servidor do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) atua como um proxy entre um serviço externo que fornece contexto, dados ou recursos para um modelo de linguagem grande (LLM, na sigla em inglês) ou um aplicativo de IA. Os servidores do MCP conectam aplicativos de IA a sistemas externos, como bancos de dados e serviços da Web, traduzindo as respostas em um formato que o aplicativo de IA possa entender.

Ferramentas do MCP

Uma ferramenta do MCP é uma função ou capacidade executável que um servidor do MCP expõe a um LLM ou aplicativo de IA para realizar uma ação no mundo real.

O servidor do MCP gmailmcp.googleapis.com tem as seguintes ferramentas:

Ferramentas do MCP
create_draft

Cria um novo rascunho de e-mail na conta do Gmail do usuário autenticado.

Essa ferramenta recebe endereços de destinatários, um assunto e o conteúdo do corpo como entradas. Ela retorna o ID do rascunho do Gmail criado.
list_drafts

Lista os rascunhos de e-mail 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.
get_thread Recupera uma conversa de e-mail específica da conta do Gmail do usuário autenticado, incluindo uma lista das mensagens.
search_threads

Lista as conversas de e-mail da conta do Gmail do usuário autenticado.

Essa ferramenta pode filtrar conversas com base em uma string de consulta e oferece suporte à paginação. Ela retorna uma lista de conversas, incluindo os IDs e as mensagens relacionadas. Cada mensagem relacionada contém detalhes como um snippet do corpo da mensagem, o assunto, o remetente, os destinatários etc. Os corpos completos das mensagens não são retornados por essa ferramenta. Use a ferramenta "get_thread" com um ID de conversa para buscar o corpo completo da mensagem, se necessário.
label_thread

Adiciona marcadores a uma conversa inteira na conta do Gmail do usuário autenticado. Essa operação afeta todas as mensagens na conversa e as futuras mensagens adicionadas a ela.

Se você não tiver certeza do ID da conversa, use a ferramenta search_threads primeiro.

Se você não tiver certeza do ID de um marcador de usuário, use a ferramenta list_labels primeiro para descobrir os marcadores disponíveis e os IDs deles.
unlabel_thread Remove marcadores de uma conversa inteira na conta do Gmail do usuário autenticado. Se você não tiver certeza do ID da conversa, use a ferramenta search_threads primeiro. Se você não tiver certeza do ID de um marcador de usuário, use a ferramenta list_labels primeiro.
list_labels Lista todos os marcadores definidos pelo usuário disponíveis na conta do Gmail do usuário autenticado. Use essa ferramenta para descobrir o id de um marcador de usuário antes de chamar label_thread, unlabel_thread, label_message ou unlabel_message. Os marcadores do sistema não são retornados por essa ferramenta, mas podem ser usados com os IDs conhecidos: "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT", "CHAT", "DRAFT", "SENT".
label_message

Adiciona um ou mais marcadores a uma mensagem específica na conta do Gmail do usuário autenticado.

Para encontrar o ID da mensagem, use ferramentas como search_threads ou get_thread. Se você não tiver certeza do ID de um marcador de usuário, use a ferramenta list_labels primeiro para descobrir os marcadores disponíveis e os IDs deles.
unlabel_message Remove um ou mais marcadores de uma mensagem específica na conta do Gmail do usuário autenticado. Para encontrar o ID da mensagem, use ferramentas como search_threads ou get_thread. Se você não tiver certeza do ID de um marcador de usuário, use a ferramenta list_labels primeiro para descobrir os marcadores disponíveis e os IDs deles.
create_label Cria um novo marcador na conta do Gmail do usuário autenticado.

Receber especificações da ferramenta MCP

Para receber as especificações da ferramenta MCP de todas as ferramentas em um servidor do MCP, use o método tools/list. O exemplo a seguir demonstra como usar curl para listar todas as ferramentas e especificações disponíveis no servidor do 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/list",
    "jsonrpc": "2.0",
    "id": 1
}'