Gmail MCP

Gmail MCP

Permita que o Claude pesquise e recupere e-mails da sua conta do Gmail.

Configuração

1. Obter Credenciais da API do Google

1. Visite o Google Cloud Console
2. Crie um novo projeto ou selecione um existente
3. Ative a API do Gmail para o seu projeto
   • Navegue até "APIs & Services" > "Library"
   • Pesquise por "Gmail API" e ative-a
4. Crie credenciais OAuth:
   • Vá para "APIs & Services" > "Credentials"
   • Clique em "Create Credentials" > "OAuth client ID"
   • Selecione "Desktop application" como o tipo de aplicativo
   • Dê um nome ao seu cliente e clique em "Create"
5. Baixe o arquivo JSON de credenciais
6. Salve-o como credentials.json no diretório do seu projeto

2. Autorizar o Aplicativo

Execute o comando de autorização para gerar seu token:

uv run gmail-mcp auth --creds-path credentials.json --token-path token.json

Isso abrirá uma janela do navegador onde você precisará fazer login na sua conta do Google e conceder as permissões necessárias. Após a autorização, um arquivo token.json será criado no diretório do seu projeto.

Configurando com o Claude

Adicione o servidor Gmail MCP ao seu arquivo de configuração do Claude:

{
  "mcpServers": {
    "gmail": {
      "args": [
        "--from",
        "git+https://github.com/vinayak-mehta/gmail-mcp",
        "gmail-mcp"
      ],
      "command": "/Users/username/.local/bin/uvx",
      "env": {
        "GMAIL_CREDS_PATH": "/Users/username/path/to/gmail-mcp/credentials.json",
        "GMAIL_TOKEN_PATH": "/Users/username/path/to/gmail-mcp/token.json"
      }
    }
  }
}

Certifique-se de:

• Substitua /Users/username/path/to/gmail-mcp pelo caminho real do seu projeto
• Ajuste o caminho command para o executável uvx instalado
• Forneça caminhos corretos para seus arquivos credentials.json e token.json

O Claude agora terá acesso às seguintes ferramentas:

1. Pesquisar E-mails

Pesquise e-mails na sua conta do Gmail.

Exemplo de prompt:

"Pesquise todos os e-mails de example@gmail.com"

2. Obter Conteúdo do E-mail

Recupere o conteúdo completo de um e-mail específico.

Exemplo de prompt:

"Mostre-me o conteúdo completo do e-mail com o assunto 'Meeting Tomorrow'"

3. Listar Mensagens

Liste mensagens recentes da sua caixa de entrada do Gmail.

Exemplo de prompt:

"Liste meus 5 e-mails mais recentes"

Variáveis de Ambiente

Você pode configurar os caminhos para seus arquivos de credenciais e token usando variáveis de ambiente:

• GMAIL_CREDS_PATH: Caminho para o seu arquivo credentials.json
• GMAIL_TOKEN_PATH: Caminho para o seu arquivo token.json

Crie um arquivo .env na raiz do projeto com essas variáveis para facilitar a configuração.