Google Calendar

Google Calendar MCP Server

Interaja com seu Google Calendar através do Claude Desktop usando o Model Context Protocol (MCP).

Este é um servidor MCP baseado em TypeScript que implementa a integração com o Google Calendar. Ele demonstra conceitos centrais do MCP enquanto fornece:

• Gerenciamento de eventos do calendário através de URIs MCP
• Ferramentas para criar e modificar eventos
• Prompts para gerar insights do calendário

Funcionalidades

Resources

• Acesse eventos do calendário via URIs MCP
• Cada evento tem título, horário, descrição e participantes
• Dados estruturados de eventos com tipos MIME apropriados

Tools

• create_event - Crie novos eventos de calendário
  • Recebe título, horário e outros detalhes do evento como parâmetros
  • Interage diretamente com a API do Google Calendar
• list_events - Visualize os próximos eventos do calendário
• [Adicione outras ferramentas que você implementou]

Prompts

• analyze_schedule - Gere insights sobre seu calendário
  • Inclui eventos futuros como recursos incorporados
  • Retorna um prompt estruturado para análise do LLM
• [Adicione outros prompts que você implementou]

Pré-requisitos

• Node.js (v14 ou superior)
• Um projeto no Google Cloud com a API do Google Calendar habilitada
• Credenciais de cliente OAuth 2.0

Desenvolvimento

Instale o devbox seguindo as instruções em devbox.sh

curl -fsSL https://get.jetpack.io/devbox | bash

Inicialize o devbox no diretório do projeto:

devbox init

Inicie o shell do devbox:

devbox shell

Instale as dependências:

npm install

Compile o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Instalação

Para usar com o Claude Desktop, adicione a configuração do servidor:

No MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json No Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Google Calendar": {
      "command": "/path/to/Google Calendar/build/index.js"
    }
  }
}

Configuração Inicial

1. Configure as credenciais do Google Cloud:

   • Acesse o Google Cloud Console
   • Crie um novo projeto ou selecione um existente
   • Habilite a API do Google Calendar
   • Crie credenciais OAuth 2.0 (tipo Aplicativo de desktop)
   • Baixe o arquivo JSON do segredo do cliente
   • Renomeie para .client_secret.json e coloque-o na raiz do projeto

2. Autenticação Inicial:

   • Ao executar o servidor pela primeira vez, ele fornecerá uma URL de autenticação
   • Visite a URL no seu navegador
   • Conceda as permissões solicitadas
   • Copie o código de autorização fornecido
   • Cole o código de volta no prompt da CLI

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector, que está disponível como um script de pacote:

npm run inspector

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.