--- title: Setup MCPs para /today date: 2025-01-21 status: activo --- # Setup MCPs para /today ## Estado Actual | MCP | Estado | Notas | |-----|--------|-------| | desk-crm-v3 | ✅ Activo | Tickets, projectos, tarefas | | filesystem | ✅ Activo | Notas Obsidian | | memory-supabase | ✅ Activo | Persistência | | imap | ✅ Activo | 12 contas email | | google-workspace | ⏸️ Opcional | Calendar (se necessário) | --- ## MCP IMAP (Principal) ### Contas Configuradas (12) ``` emanuel@descomplicar.pt it@descomplicar.pt help@descomplicar.pt suporte@descomplicar.pt contabilidade@descomplicar.pt financeiro@descomplicar.pt info@descomplicar.pt rh@descomplicar.pt mkt@descomplicar.pt design@descomplicar.pt news@descomplicar.pt aiktop@descomplicar.pt ``` ### Ferramentas Disponíveis | Ferramenta | Função | |------------|--------| | `imap_list_accounts` | Listar contas disponíveis | | `imap_list_folders` | Listar pastas de uma conta | | `imap_list_emails` | Listar emails de uma pasta | | `imap_read_email` | Ler email por UID | | `imap_search_emails` | Pesquisar emails | | `imap_move_email` | Mover email entre pastas | | `imap_delete_email` | Eliminar email | ### Acções Automáticas Diárias 1. **SPAM** → `imap_delete_email` 2. **Promocionais** → `imap_move_email` para "Promotions" 3. **Facturas pagas** → Reencaminhar para contabilidade@descomplicar.pt 4. **Prioritários** → Listar no relatório ### Regras de Triagem Ver: `config/email-triage-rules.md` --- ## Google Workspace MCP (Opcional) ### Localização ``` ~/mcp-servers/google_workspace_mcp/ ``` ### Capacidades - **Gmail**: Pesquisa, envio, gestão de emails - **Calendar**: Eventos, reuniões, agenda - **Drive**: Ficheiros (opcional) - **Docs/Sheets**: Documentos (opcional) ### Requisitos para Activar 1. **Google Cloud Console** - Criar projecto ou usar existente - Activar Gmail API - Activar Calendar API - Criar credenciais OAuth (Desktop App) 2. **Credenciais necessárias** ``` GOOGLE_OAUTH_CLIENT_ID=xxx GOOGLE_OAUTH_CLIENT_SECRET=xxx USER_GOOGLE_EMAIL=emanuel@descomplicar.pt ``` 3. **Ficheiros existentes** - `client_secret.json` ✅ Existe - `token.json` ✅ Existe - `.env` ✅ Existe ### Verificar Estado ```bash cd ~/mcp-servers/google_workspace_mcp cat .env # Verificar se credenciais estão preenchidas ``` ### Adicionar ao Claude settings.json ```json { "mcpServers": { "google-workspace": { "command": "python", "args": ["-m", "workspace_mcp"], "cwd": "/home/ealmeida/mcp-servers/google_workspace_mcp", "env": { "GOOGLE_OAUTH_CLIENT_ID": "...", "GOOGLE_OAUTH_CLIENT_SECRET": "...", "USER_GOOGLE_EMAIL": "emanuel@descomplicar.pt" } } } } ``` --- ## Passos para Completar Setup ### 1. Verificar credenciais Google ```bash cd ~/mcp-servers/google_workspace_mcp cat .env cat client_secret.json ``` ### 2. Testar MCP localmente ```bash cd ~/mcp-servers/google_workspace_mcp source venv/bin/activate python -m workspace_mcp --test ``` ### 3. Adicionar ao Claude Editar `~/.claude/settings.json` com configuração acima. ### 4. Reiniciar Claude Code ```bash claude --version # Fechar e reabrir ``` ### 5. Testar no /today ```bash # Executar /today e verificar se Gmail/Calendar funcionam ``` --- ## Funcionalidades Quando Activo ### Gmail - `list_emails` - Listar emails - `search_emails` - Pesquisar emails - `get_email` - Ver email específico - `send_email` - Enviar email - `create_draft` - Criar rascunho ### Calendar - `list_events` - Listar eventos - `get_event` - Ver evento - `create_event` - Criar evento - `update_event` - Actualizar evento - `delete_event` - Eliminar evento --- ## Alternativa: MCP Gmail Dedicado Se preferir usar apenas Gmail (mais leve): ``` ~/mcp-servers/mcp-gmail.tar.gz ``` Extrair e configurar separadamente. --- **Última actualização**: 2025-01-21