Servidor MCP Gmail | Awesome MCP Servers

Servidor MCP do Gmail

Este servidor MCP (Model Context Protocol) fornece ferramentas para operações comuns com o Gmail.

Recursos

send_mail: Enviar novos e-mails

Pré-requisitos

Python 3.12+
uv - Instalador e resolvedor de pacotes Python rápido
Configuração do Google Cloud Console

Acesse: Google Cloud Console
Crie um novo projeto para este servidor MCP
Ative a API do Gmail
- Acesse: APIs e serviços > Biblioteca
- Pesquise: API do Gmail
- Clique em: API do Gmail nos resultados
- Clique em: Ativar
Configure o OAuth
- Acesse: APIs e serviços > Credenciais
- Clique em: Criar credenciais > ID do cliente OAuth
- Escolha o tipo de aplicativo: Aplicativo web
- Adicione: URIs de redirecionamento autorizados: http://localhost:4321/
- Crie o cliente
- Baixe o JSON e salve-o em credentials.json na raiz deste projeto. Isso contém o ID do cliente, Segredo do cliente, etc.

Instalação

Clone este repositório:

git clone https://github.com/heuristech/gmail-mcp-server.git
cd gmail-mcp-server

Crie um ambiente virtual e instale o pacote em modo de desenvolvimento:

# Create a virtual environment
uv venv

# Activate the virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate

# Install dependencies
uv sync

Obter Token de Atualização

python get_refresh_token.py

Isso irá:

Iniciar um servidor em port: 4321 para receber tokens após o OAuth do Google
Abrir seu navegador para o OAuth do Google
Após autenticação bem-sucedida, salvará token.json com refresh_token juntamente com client_id e client_secret.
Também exibirá o refresh_token no console.

Criar .env

copy example.env .env

Configure o valor correspondente usando o que você recebeu na etapa anterior.

Inspecionar

Use o MCP Inspector para testar em modo de desenvolvimento.

mcp dev server.py

Integração com Claude Desktop

Quando seu servidor estiver pronto, instale-o no Claude Desktop

mcp install server.py --with google-auth --with google-auth-oauthlib --with google-auth-httplib2 --with google-api-python-client -f .env

Configuração do servidor MCP:

{
  "mcpServers": {
    "gmail-mcp-server": {
      "command": "uv",
      "args": [
          "--directory",
          "/:your.path.to/gmail-mcp-server/server.py",
          "run",
          "server.py"
      ],
      "env": {
        "CLIENT_ID": "google.auth.app.client.id",
        "CLIENT_SECRET": "google.auth.app.client.secret",
        "REFRESH_TOKEN": "google.auth.app.refresh.token"
      }   
    }   
  }
}

Gmail

Documentação