1. Acesse o Google Cloud Console;
2. Crie um novo projeto ou selecione um já existente;
3. Insira o nome do projeto (por exemplo, "gmail mcp agent");
4. Aceite as configurações sugeridas de organização e localização;
5. Clique em Criar e aguarde a inicialização do projeto.

1. No menu lateral, acesse "APIs e Serviços" → "Biblioteca";
2. Pesquise por "Gmail API";
3. Selecione o primeiro resultado e clique em "Ativar";
4. Isso concede permissão ao seu projeto para acessar funcionalidades do Gmail.

1. Navegue até a aba "Credenciais";
2. Se solicitado, clique em "Configurar tela de consentimento";
3. Clique em "Começar";
4. Insira o nome do aplicativo (por exemplo, "gmail agent");
5. Informe seu endereço de e-mail;
6. Selecione "Público externo" para o tipo de usuário, caso utilize uma conta Gmail comum;
7. Insira novamente seu endereço de e-mail quando solicitado;
8. Aceite a política de dados do usuário;
9. Clique em Continuar e Criar.

1. Clique em "Criar cliente OAuth";
2. Selecione "Aplicativo Web";
3. Aceite o nome sugerido ou personalize;
4. Clique em "Adicionar URI";
5. Insira o URI de redirecionamento: http://localhost:3000/oauth2callback;
6. Clique no botão azul Criar;
7. Baixe o arquivo de credenciais JSON;
8. Renomeie o arquivo para: gsp-oauth.keys.json.

Acesse seu diretório raiz/pasta inicial:

• Mac: Pasta Home Users/user_name ou Windows: C:\Users\Your_Username\;
• Use Command + Shift + . (Mac) ou Ctrl + Shift + . (Windows) para exibir arquivos ocultos;
• Crie uma nova pasta chamada: .gmail-mcp;
• Mova o arquivo gsp-oauth.keys.json para esta pasta;
• Use Command + Shift + . novamente para ocultar as pastas.

O servidor está configurado para localizar automaticamente as credenciais neste diretório.

• Abra o Claude com o Desktop Commander MCP instalado. Para configuração rápida, utilize o comando Smithery;
• Em um novo chat do Claude, digite o prompt:

run npx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude

• Durante a execução, o Claude solicitará permissão para usar o Desktop Commander MCP. Clique em Permitir sempre ou Permitir uma vez;
• Você será redirecionado para uma página de autenticação do Google. Selecione o mesmo e-mail utilizado para o projeto Cloud. Clique em Permitir para conceder acesso ao Gmail. Aguarde pela mensagem de sucesso;
• Reinicie o Claude Desktop. O novo servidor deverá aparecer como conectado.

• Copie o prompt e cole em um chat novo ou já aberto do Claude:

add next config block to claude config file
{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

• Execute o prompt → o Claude irá atualizar o arquivo de configuração.
• Confirme se o bloco foi adicionado corretamente (Opcional). Vá em Configurações (atalho: Cmd + ,) → Desenvolvedor → Editar Configuração → abra o arquivo claude_desktop_config.json em um editor de texto;
• Feche completamente e reabra o Claude Desktop.

Atualizar Arquivo de Configuração

• No Claude Desktop, pressione Command + , (Mac) ou Ctrl + , (Windows);
• Clique em "Editar Configuração";
• Abra o arquivo de configuração em um editor de texto;
• Copie o bloco de configuração;

{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    },
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

• Cole no seu arquivo de configuração do Claude após o bloco de configuração anterior e antes das duas últimas chaves de fechamento;
• Salve o arquivo (Command/Ctrl + S);
• Feche completamente e reabra o Claude Desktop.