MCP Reference: gmailmcp.googleapis.com

Este é um servidor MCP fornecido pela API Gmail. O servidor oferece ferramentas para que os desenvolvedores criem aplicativos LLM com base no Gmail.

Um servidor do Protocolo de Contexto de Modelo (MCP) atua como um proxy entre um serviço externo que fornece contexto, dados ou recursos para um modelo de linguagem grande (LLM) ou aplicativo de IA. Os servidores 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.

Configuração do servidor

Você precisa configurar o servidor MCP do Gmail antes de usar. Para mais informações sobre como usar servidores MCP remotos do Google e do Google Cloud, consulte Visão geral dos servidores MCP do Google Cloud.

Endpoints do servidor

Um endpoint de serviço MCP é o endereço de rede e a interface de comunicação (geralmente um URL) do servidor MCP que um aplicativo de IA (o host do cliente MCP) usa para estabelecer uma conexão segura e padronizada. É o ponto de contato para o LLM solicitar contexto, chamar uma ferramenta ou acessar um recurso. Os endpoints do MCP do Google podem ser globais ou regionais.

O servidor MCP da API Gmail tem o seguinte endpoint MCP global:

  • https://gmailmcp.googleapis.com/mcp/v1

Ferramentas do MCP

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

Ferramentas

O servidor 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 IDs e assuntos.
get_thread Recupera uma conversa de e-mail específica da conta do Gmail do usuário autenticado, incluindo uma lista de 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 IDs e 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 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 MCP.

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/list",
    "jsonrpc": "2.0",
    "id": 1
}'