Gmail

Gmail MCP Server

Um servidor baseado no Model Context Protocol (MCP) que fornece funcionalidades de exclusão de e-mails do Gmail.

Funcionalidades

• Expõe ferramentas de exclusão de e-mails do Gmail através do protocolo MCP
• Suporta exclusão de e-mails de usuários específicos por ID de e-mail
• Oferece funcionalidade de busca de e-mails, com suporte a consultas por critérios
• Suporta exclusão em lote de múltiplos e-mails de usuários específicos

Requisitos de ambiente

• Java 17 ou superior
• Maven 3.6+ ou Gradle 7.0+
• Arquivo credentials.json da API do Gmail

Início rápido

1. Preparar credenciais da API do Gmail

1. Acesse o Google Cloud Console
2. Crie um novo projeto e habilite a API do Gmail
3. Crie credenciais de ID de cliente OAuth 2.0
4. Baixe o arquivo credentials.json e salve-o no diretório src/main/resources/

2. Compilar o projeto

./mvnw clean install

3. Executar o servidor

./mvnw spring-boot:run

Configuração

O arquivo de configuração está localizado em src/main/resources/application.properties e os seguintes parâmetros podem ser modificados:

• server.port: Porta do servidor, padrão 8080
• spring.ai.mcp.server.enabled: Se o servidor MCP está habilitado, padrão true
• gmail.credentials.path: Caminho do arquivo de credenciais do Gmail, padrão classpath:credentials.json

Como usar

Após conectar-se ao servidor através de um cliente MCP, as seguintes ferramentas podem ser chamadas:

• deleteEmail: Excluir e-mail com ID específico
  • Parâmetros: userId (e-mail do usuário), messageId (ID do e-mail)
• searchEmails: Buscar e-mails que correspondem aos critérios
  • Parâmetros: userId (e-mail do usuário), query (critérios de busca), maxResults (número máximo de resultados)
  • Valor de retorno: lista de e-mails, contendo ID do e-mail e informações básicas
• batchDeleteEmails: Excluir e-mails em lote
  • Parâmetros: userId (e-mail do usuário), messageIds (lista de IDs de e-mail)
  • Valor de retorno: status do resultado da operação

Configuração do servidor MCP

{
  "mcpServers": {
    "gmail-mcp-server": {
    "command": "java",
    "args": [
      "-Dspring.ai.mcp.server.stdio=true",
      "-Dspring.main.web-application-type=none",
      "-Dlogging.pattern.console=",
      "-jar",
      "/Users/arthur/.m2/repository/arthur/mcp/gmail-mcp-server/0.0.1-SNAPSHOT/gmail-mcp-server-0.0.1-SNAPSHOT.jar"
    ]
    }
  }
}