claude-plugins/gestao/skills/calendar-manager/references/mcp-tools-referencia.md

Calendar Manager - Referencia MCP Tools

Constantes

const CALENDARIOS = {
  PESSOAL: 'emanuelalmeidaa@gmail.com',
  PROFISSIONAL: 'emanuel@descomplicar.pt',
  CLIENTES: 'info@descomplicar.pt',
  FERIADOS: 'pt-pt.portuguese#holiday@group.v.calendar.google.com'
};

const TIMEZONE = 'Europe/Lisbon';
const USER_EMAIL = 'emanuelalmeidaa@gmail.com';
const DURACAO_DEFAULT = 60;  // minutos

Google Workspace MCP - Referencia Completa

Listar calendarios disponiveis

mcp__google_workspace__list_calendars({
  user_google_email: 'emanuelalmeidaa@gmail.com'
});

Obter eventos

mcp__google_workspace__get_events({
  user_google_email: 'emanuelalmeidaa@gmail.com',
  calendar_id: 'emanuelalmeidaa@gmail.com',  // ou 'ALL' para todos
  time_min: '2026-02-04T00:00:00',  // ISO 8601
  time_max: '2026-02-04T23:59:59'
});

Criar evento

mcp__google_workspace__create_event({
  user_google_email: 'emanuelalmeidaa@gmail.com',
  calendar_id: 'emanuelalmeidaa@gmail.com',
  summary: 'Titulo do evento',
  start_time: '2026-02-04T14:30:00',
  end_time: '2026-02-04T15:30:00',
  timezone: 'Europe/Lisbon',
  description: 'Descricao opcional',
  location: 'Local opcional'
});

Modificar evento

mcp__google_workspace__modify_event({
  user_google_email: 'emanuelalmeidaa@gmail.com',
  calendar_id: 'emanuelalmeidaa@gmail.com',
  event_id: 'id_do_evento',
  summary: 'Novo titulo',
  start_time: 'nova_data'
});

Eliminar evento

mcp__google_workspace__delete_event({
  user_google_email: 'emanuelalmeidaa@gmail.com',
  calendar_id: 'emanuelalmeidaa@gmail.com',
  event_id: 'id_do_evento'
});

Checklist de Criacao

Antes de criar evento, verificar:

• Calendario correcto identificado (pessoal/profissional/clientes)
• Data valida (nao no passado, salvo excepcoes)
• Hora valida (formato HH:MM ou HH:MM-HH:MM)
• Duracao razoavel (<12h, excepto dias completos)
• Sem conflitos (ou utilizador confirmou)
• Timezone correcto (Europe/Lisbon)
• Titulo descritivo