Google Calendar

Interaja com o Google Agenda para gerenciar eventos, cronogramas e reuniões.

Documentação

📅 Servidor MCP do Google Calendar

Um poderoso servidor Model Context Protocol (MCP) que permite ao Claude interagir com seu Google Calendar de forma integrada!

Transforme o Claude em seu assistente pessoal de calendário com integração completa ao Google Calendar. Crie reuniões, verifique agendas, gerencie eventos e muito mais — tudo por meio de conversas naturais com o Claude.

🌟 O Que Isso Pode Fazer?

✨ Gerenciamento Inteligente de Calendário

📋 Veja todos os seus calendários — Consulte todos os calendários aos quais você tem acesso
📅 Verifique sua agenda — Obtenha os eventos de hoje ou os próximos eventos em qualquer período
🎯 Crie reuniões instantaneamente — Configure eventos do Google Meet com participantes
❌ Cancele eventos — Remova eventos que você não precisa mais
🔍 Pesquise eventos — Encontre eventos em intervalos de datas específicos

🤖 Exemplos de Integração com o Claude

Pergunte ao Claude coisas como:

"Quais reuniões tenho hoje?"
"Agende um standup da equipe para amanhã às 10h com o time de engenharia"
"Cancele minha reunião das 15h de sexta-feira"
"Como está minha agenda para a próxima semana?"
"Crie um Google Meet para nossa revisão com o cliente na próxima terça-feira"

🚀 Início Rápido

Etapa 1: Pré-requisitos

Python 3.8 ou superior
Uma conta do Google com acesso ao Calendar
Conta Nango para autenticação (gerencia o OAuth do Google para você)

Etapa 2: Instalação

# Clone or download the MCP server files
git clone <your-repo-url>
cd google-calendar-mcp

# Install required packages
uv sync

Etapa 3: Configure as Variáveis de Ambiente

Crie um arquivo .env no diretório do projeto:

# Copy the example file
cp .env.example .env

Edite o .env com suas credenciais do Nango:

# Required Nango Configuration
NANGO_NANGO_BASE_URL=https://api.nango.dev
NANGO_NANGO_SECRET_KEY=your_nango_secret_key_here 
NANGO_CONNECTION_ID=your_connection_id_here
NANGO_INTEGRATION_ID=your_integration_id_here

🔧 Precisa de ajuda com a configuração do Nango? Consulte o Guia de Configuração do Nango abaixo!

Etapa 4: Configure o Claude Desktop

Adicione esta configuração às configurações do seu Claude Desktop:

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

{
  "mcpServers": {
    "google-calendar": {
      "command": "uvx",
      "args": ["git+https://github.com/Shameerpc5029/google-calendar-mcp.git"],
      "env": {
        "NANGO_NANGO_BASE_URL": "https://api.nango.dev",
        "NANGO_NANGO_SECRET_KEY": "your_nango_secret_key_here",
        "NANGO_CONNECTION_ID": "your_connection_id_here", 
        "NANGO_INTEGRATION_ID": "your_integration_id_here"
      }
    }
  }
}

Etapa 5: Teste!

Reinicie o Claude Desktop completamente
Inicie uma nova conversa com o Claude
Pergunte ao Claude: "Quais reuniões tenho hoje?"

Se tudo estiver configurado corretamente, o Claude poderá acessar seu Google Calendar! 🎉

🛠️ Ferramentas Disponíveis

Ferramenta	Descrição	Exemplo de Uso
`get_all_calendars`	Liste todos os seus calendários do Google	"Mostre-me todos os meus calendários"
`get_calendar_events`	Obtenha eventos de um calendário específico	"O que há no meu calendário de trabalho esta semana?"
`create_meet_event`	Crie um novo evento com Google Meet	"Agende uma reunião de equipe para sexta-feira às 14h"
`cancel_calendar_event`	Exclua/cancele um evento	"Cancele minha reunião das 15h de hoje"
`get_today_events`	Obtenha os eventos de hoje	"Qual é minha agenda de hoje?"
`get_upcoming_events`	Obtenha os próximos eventos	"O que tenho na próxima semana?"

🔧 Guia de Configuração do Nango

O Nango gerencia o fluxo complexo de OAuth do Google para você. Veja como configurá-lo:

1. Crie uma Conta Nango

Acesse Nango.dev e cadastre-se
Crie um novo projeto

2. Configure a Integração com o Google Calendar

No painel do Nango, adicione uma nova integração
Escolha "Google Calendar" como provedor
Siga o guia do Nango para configurar as credenciais OAuth do Google

3. Obtenha Suas Credenciais

NANGO_SECRET_KEY: Encontrada nas configurações do seu projeto Nango
NANGO_CONNECTION_ID: Criada quando um usuário conecta sua conta do Google
NANGO_INTEGRATION_ID: O ID da sua integração com o Google Calendar

4. Teste Sua Conexão

# Test that your environment is set up correctly
python -c "import os; print('✅ All env vars set!' if all([os.getenv('NANGO_CONNECTION_ID'), os.getenv('NANGO_INTEGRATION_ID'), os.getenv('NANGO_NANGO_SECRET_KEY')]) else '❌ Missing env vars')"

🧪 Testando Sua Configuração

Opção 1: Teste com o MCP Inspector

# Install the MCP inspector
npm install -g @modelcontextprotocol/inspector

# Test your server
npx @modelcontextprotocol/inspector python main.py

Opção 2: Teste Direto com Python

# Run the server directly to see if it starts without errors
python main.py

Opção 3: Teste com o Claude

Pergunte ao Claude: "Você pode verificar quais ferramentas de calendário estão disponíveis?"

🔍 Solução de Problemas

Problemas Comuns

❌ "Falha ao recuperar calendários"

Verifique suas credenciais do Nango no .env
Confirme sua conexão com o Google Calendar no painel do Nango
Garanta que a conta do Google tenha acesso ao calendário

❌ "A variável de ambiente NANGO_CONNECTION_ID é obrigatória"

Certifique-se de que seu arquivo .env esteja no mesmo diretório do script Python
Verifique se todas as variáveis de ambiente estão configuradas corretamente
Reinicie o Claude Desktop após fazer alterações

❌ O Claude não consegue encontrar as ferramentas de calendário

Verifique se o caminho completo na configuração do Claude está correto
Certifique-se de ter reiniciado o Claude Desktop completamente
Verifique os logs do Claude Desktop para mensagens de erro

Obtendo Ajuda

Verifique os logs: O Claude Desktop mostra os logs do servidor MCP no console do desenvolvedor
Teste seu .env: Execute python -c "from dotenv import load_dotenv; load_dotenv(); import os; print(os.environ.get('NANGO_CONNECTION_ID'))"
Verifique os caminhos dos arquivos: Certifique-se de que todos os caminhos na configuração do Claude sejam caminhos absolutos

📋 Exemplo de Uso com o Claude

Após a configuração, você pode ter conversas naturais com o Claude sobre seu calendário:

Você: "Como está minha agenda hoje?"

Claude: Vou verificar seu calendário para os eventos de hoje.

{
  "success": true,
  "events": [
    {
      "summary": "Team Standup",
      "start": "2024-01-15T09:00:00Z",
      "end": "2024-01-15T09:30:00Z"
    }
  ],
  "total_events": 1
}

Você tem 1 evento hoje: Standup da Equipe das 9h às 9h30.

Você: "Agende uma reunião com o cliente para sexta-feira às 14h com john@company.com"

Claude: Vou criar essa reunião para você com um link do Google Meet.

{
  "success": true,
  "event": {
    "summary": "Client Meeting",
    "start": "2024-01-19T14:00:00Z",
    "attendees": [{"email": "john@company.com"}]
  }
}

✅ Reunião com o Cliente criada para sexta-feira, 19 de janeiro, às 14h com john@company.com. O link do Google Meet foi incluído automaticamente.

🔐 Segurança e Privacidade

Suas credenciais: Armazenadas localmente no seu arquivo .env — nunca compartilhadas
Acesso ao Google: Gerenciado pelo fluxo seguro de OAuth do Nango
Tratamento de dados: Todos os dados do calendário permanecem entre sua conta do Google, o Nango e o Claude
Sem armazenamento de dados: Este servidor MCP não armazena nenhuma informação do seu calendário

🤝 Contribuindo

Encontrou um bug ou quer adicionar um recurso?

Faça um fork do repositório
Crie um branch de recurso
Faça suas alterações
Teste minuciosamente
Envie um pull request

📄 Licença

Licença MIT — sinta-se à vontade para usar isso em seus próprios projetos!

🎉 Aproveite seu novo assistente de calendário com IA!

Se você achou isso útil, considere dar uma estrela no repositório e compartilhar com outras pessoas que possam se beneficiar do gerenciamento de calendário com IA.