Servidor Headless Gmail MCP

O que faz o servidor “Headless Gmail” MCP?

O Servidor Headless Gmail MCP é um servidor Model Context Protocol (MCP) que permite interação perfeita com contas do Gmail para envio e recebimento de e-mails, tudo isso sem a necessidade de configuração local de credenciais ou tokens. Projetado para operação sem interface e remota, permite que clientes completem fluxos OAuth de forma independente e passem credenciais de maneira segura como contexto, tornando possível rodar em ambientes totalmente conteinerizados ou em nuvem sem acesso a arquivos locais ou interação com navegador. Este servidor é ideal para fluxos de trabalho que precisam de acesso ao Gmail focado e confiável — como automação de marketing ou sistemas de notificações — expondo ferramentas padronizadas via interface MCP para gerenciamento de e-mails e integração em pipelines de desenvolvimento com IA.

Lista de Prompts

Nenhum modelo de prompt específico é mencionado no repositório.

Lista de Recursos

Nenhum recurso MCP explícito é descrito na documentação ou código disponível.

Lista de Ferramentas

• Obter e-mails recentes
  Recupera os e-mails mais recentes de uma conta Gmail, retornando os primeiros 1.000 caracteres do corpo do e-mail.
• Obter corpo completo do e-mail
  Busca o conteúdo completo de um e-mail em blocos de 1.000 caracteres usando um parâmetro de offset, permitindo a recuperação de e-mails grandes.
• Enviar e-mail
  Envia e-mails pela conta Gmail conectada.
• Atualizar token de acesso
  Gerencia a atualização de tokens de forma independente, garantindo acesso seguro contínuo.

Casos de Uso deste Servidor MCP

• Notificações Automáticas por E-mail
  Integre com agentes de IA ou plataformas de automação para enviar alertas ou notificações por e-mail em tempo real sem intervenção manual.
• Monitoramento da Caixa de Entrada do Gmail
  Busque e processe os e-mails mais recentes para automatizar respostas, triagem ou extrair informações para fluxos de trabalho subsequentes.
• Automação de Campanhas de Marketing
  Envie e-mails de marketing personalizados programaticamente, utilizando MCP para execução de campanhas em escala, separando as credenciais.
• Integração de API Facilitada
  Incorpore operações do Gmail em ambientes de desenvolvimento ou outras plataformas compatíveis com MCP sem expor ou gerenciar credenciais locais.
• Gerenciamento Remoto/Em Nuvem de E-mails
  Gerencie contas Gmail em ambientes Dockerizados ou remotos, permitindo operação segura e sem interface, sem dependências locais.

Como configurar

Windsurf

1. Certifique-se de que Node.js e Windsurf estão instalados.
2. Abra seu arquivo de configuração (ex: windsurf.json).
3. Adicione o Servidor Headless Gmail MCP à seção mcpServers:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. Salve as alterações e reinicie o Windsurf.
5. Verifique se o servidor está rodando pelo painel do Windsurf.

Protegendo as Chaves de API
Utilize variáveis de ambiente para passar as credenciais de forma segura:

{
  "mcpServers": {
    "headless-gmail": {
      "command": "npx",
      "args": ["@baryhuang/mcp-headless-gmail@latest"],
      "env": {
        "GMAIL_CLIENT_ID": "...",
        "GMAIL_CLIENT_SECRET": "...",
        "GMAIL_ACCESS_TOKEN": "...",
        "GMAIL_REFRESH_TOKEN": "..."
      }
    }
  }
}

Claude

1. Instale o Claude e certifique-se de que o Node.js está disponível.
2. Edite o arquivo de configuração (ex: claude.json).
3. Adicione o servidor:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. Salve e reinicie o Claude.
5. Verifique o status do servidor na interface do Claude.

Protegendo as Chaves de API
Use a chave env como acima para injetar as credenciais de forma segura.

Cursor

1. Certifique-se de que o Cursor está instalado e atualizado.
2. Abra as configurações ou arquivo de configuração do Cursor.
3. Insira a entrada do servidor MCP:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. Salve e reinicie o Cursor.
5. Confirme que o servidor MCP foi detectado.

Protegendo as Chaves de API
Configure as credenciais usando a seção env como mostrado anteriormente.

Cline

1. Instale o Cline e as dependências.
2. Abra o arquivo de configuração do Cline.
3. Adicione o servidor MCP:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. Salve as alterações e reinicie o Cline.
5. Certifique-se da conectividade do servidor pelas ferramentas do Cline.

Protegendo as Chaves de API
Passe as credenciais de API usando variáveis de ambiente na configuração como nos exemplos anteriores.

Como usar este MCP em fluxos

Usando o MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo de trabalho FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do MCP do sistema, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "headless-gmail": {
    "transport": "streamable_http",
    "url": "https://seudomcpserver.exemplo/caminhoparaomcp/url"
  }
}

Depois de configurado, o agente de IA poderá usar este MCP como uma ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de alterar “headless-gmail” para o nome real do seu servidor MCP (ex: “github-mcp”, “weather-api”, etc.) e substituir a URL pela sua própria URL do servidor MCP.

Visão Geral

Nossa Opinião

Com base nas informações disponíveis, o Servidor Headless Gmail MCP é altamente focado e fácil de integrar, com instruções claras para a maioria das plataformas e suporte robusto para Docker/headless. Entretanto, carece de modelos de prompt explícitos e definições de recursos, o que pode limitar algumas funções avançadas do MCP. Seus pontos fortes estão na simplicidade, segurança e utilidade real para automação de e-mails. No geral, é prático e confiável para o uso pretendido, mas não tão completo em recursos quanto outros servidores MCP.

Pontuação MCP