Google Workspace MCP Server

Google Workspace MCP Server

Um servidor Model Context Protocol (MCP) que fornece ferramentas para interagir com as APIs do Gmail e do Google Agenda. Este servidor permite gerenciar seus e-mails e eventos de agenda programaticamente por meio da interface MCP.

Recursos

Ferramentas do Gmail

• list_emails: Listar e-mails recentes da sua caixa de entrada com filtragem opcional
• search_emails: Pesquisa avançada de e-mails com a sintaxe de consulta do Gmail
• send_email: Enviar novos e-mails com suporte a CC e CCO
• modify_email: Modificar rótulos de e-mail (arquivar, mover para lixeira, marcar como lido/não lido)

Ferramentas do Google Agenda

• list_events: Listar próximos eventos da agenda com filtro por intervalo de datas
• create_event: Criar novos eventos de agenda com participantes
• update_event: Atualizar eventos de agenda existentes
• delete_event: Excluir eventos de agenda

Pré-requisitos

1. Node.js: Instale o Node.js versão 14 ou superior
2. Configuração do Google Cloud Console:
   • Acesse o Console do Google Cloud
   • Crie um novo projeto ou selecione um existente
   • Ative a API do Gmail e a API do Google Agenda:
     1. Vá para "APIs e serviços" > "Biblioteca"
     2. Pesquise e ative a "API do Gmail"
     3. Pesquise e ative a "API do Google Agenda"
   • Configure as credenciais OAuth 2.0:
     1. Vá para "APIs e serviços" > "Credenciais"
     2. Clique em "Criar credenciais" > "ID do cliente OAuth"
     3. Escolha "Aplicativo da web"
     4. Defina "URIs de redirecionamento autorizados" para incluir: http://localhost:4100/code
     5. Anote o ID do cliente e o segredo do cliente

Instruções de configuração

1. Clonar e instalar:

   git clone https://github.com/epaproditus/google-workspace-mcp-server.git
   cd google-workspace-mcp-server
   npm install
   

2. Criar credenciais OAuth: Crie um arquivo credentials.json no diretório raiz:

   {
       "web": {
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET",
           "redirect_uris": ["http://localhost:4100/code"],
           "auth_uri": "https://accounts.google.com/o/oauth2/auth",
           "token_uri": "https://oauth2.googleapis.com/token"
       }
   }
   

3. Obter o token de atualização:

   node get-refresh-token.js
   

   Isso irá:

   • Abrir seu navegador para autenticação OAuth do Google
   • Solicitar as seguintes permissões:
     • https://www.googleapis.com/auth/gmail.modify
     • https://www.googleapis.com/auth/calendar
     • https://www.googleapis.com/auth/gmail.send
   • Salvar as credenciais em token.json
   • Exibir o token de atualização no console

4. Configurar as configurações do MCP: Adicione a configuração do servidor ao seu arquivo de configurações do MCP:

   • Para a extensão Claude do VSCode: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Para o aplicativo de desktop Claude: ~/Library/Application Support/Claude/claude_desktop_config.json

   Adicione isso ao objeto mcpServers:

   {
     "mcpServers": {
       "google-workspace": {
         "command": "node",
         "args": ["/path/to/google-workspace-server/build/index.js"],
         "env": {
           "GOOGLE_CLIENT_ID": "your_client_id",
           "GOOGLE_CLIENT_SECRET": "your_client_secret",
           "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
         }
       }
     }
   }
   

5. Compilar e executar:

   npm run build
   

Exemplos de uso

Operações do Gmail

1. Listar e-mails recentes:

   {
     "maxResults": 5,
     "query": "is:unread"
   }
   

2. Pesquisar e-mails:

   {
     "query": "from:example@gmail.com has:attachment",
     "maxResults": 10
   }
   

3. Enviar e-mail:

   {
     "to": "recipient@example.com",
     "subject": "Hello",
     "body": "Message content",
     "cc": "cc@example.com",
     "bcc": "bcc@example.com"
   }
   

4. Modificar e-mail:

   {
     "id": "message_id",
     "addLabels": ["UNREAD"],
     "removeLabels": ["INBOX"]
   }
   

Operações do Google Agenda

1. Listar eventos:

   {
     "maxResults": 10,
     "timeMin": "2024-01-01T00:00:00Z",
     "timeMax": "2024-12-31T23:59:59Z"
   }
   

2. Criar evento:

   {
     "summary": "Team Meeting",
     "location": "Conference Room",
     "description": "Weekly sync-up",
     "start": "2024-01-24T10:00:00Z",
     "end": "2024-01-24T11:00:00Z",
     "attendees": ["colleague@example.com"]
   }
   

3. Atualizar evento:

   {
     "eventId": "event_id",
     "summary": "Updated Meeting Title",
     "location": "Virtual",
     "start": "2024-01-24T11:00:00Z",
     "end": "2024-01-24T12:00:00Z"
   }
   

4. Excluir evento:

   {
     "eventId": "event_id"
   }
   

Solução de problemas

1. Problemas de autenticação:

   • Certifique-se de que todos os escopos OAuth necessários foram concedidos
   • Verifique se o ID do cliente e o segredo estão corretos
   • Verifique se o token de atualização é válido

2. Erros de API:

   • Verifique as cotas e limites da API no Google Cloud Console
   • Certifique-se de que as APIs estejam ativadas para o seu projeto
   • Verifique se os parâmetros da solicitação correspondem ao formato exigido

Licença

Este projeto está licenciado sob a Licença MIT.