Google Calendar

Um servidor MCP para criar e gerenciar eventos do Google Calendar.

Documentação

Configuração

  1. Instalar dependências:

    npm install
    
  2. Obter credenciais da API do Google Calendar:

    • Acesse o Google Cloud Console
    • Crie um novo projeto ou selecione um existente
    • Ative a API do Google Calendar
    • Crie as credenciais (OAuth 2.0 Client ID)
    • Baixe as credenciais e salve como credentials.json na raiz do projeto
  3. Autenticar:

    • Execute o servidor e use a ferramenta authenticate_google_calendar para obter a URL de autenticação
    • Visite a URL, conceda as permissões e obtenha o código de autorização
    • Crie um arquivo token.json com suas credenciais
  4. Configurar o Claude Code: Adicione às suas configurações do MCP:

    {
      "mcpServers": {
        "google-calendar": {
          "command": "node",
          "args": ["/Users/krilet/mcp-google-calendar-server/src/index.js"]
        }
      }
    }
    

Uso

O servidor fornece duas ferramentas:

authenticate_google_calendar

Gera uma URL de autenticação para acesso ao Google Calendar.

create_calendar_event

Cria um novo evento no seu Google Calendar.

Parâmetros:

  • summary (obrigatório): Título do evento
  • startDateTime (obrigatório): Horário de início no formato ISO
  • endDateTime (obrigatório): Horário de término no formato ISO
  • description (opcional): Descrição do evento
  • location (opcional): Local do evento
  • timeZone (opcional): Fuso horário (padrão: UTC)
  • attendees (opcional): Matriz de endereços de e-mail

Exemplo:

{
  "summary": "Team Meeting",
  "startDateTime": "2024-12-25T10:00:00-08:00",
  "endDateTime": "2024-12-25T11:00:00-08:00",
  "description": "Weekly team sync",
  "location": "Conference Room A",
  "attendees": ["colleague@example.com"]
}