MCP Google Calendar Integration

Integra com a API do Google Agenda para buscar eventos de calendário para uma data específica.

GitHub

Documentação

📅 Integração MCP Google Calendar

Este projeto é uma ferramenta Model Context Protocol (MCP) que se conecta com a API do Google Calendar para buscar eventos de calendário para uma determinada data. Ele se integra perfeitamente com editores orientados por IA, como Cursor, para aumentar sua produtividade trazendo dados de calendário em tempo real diretamente para o seu ambiente de codificação.

🔧 Recursos

  • 📆 Obter eventos de calendário para uma data específica
  • ⚡ Integração em tempo real usando MCP
  • 🧠 Comandos de ferramentas em linguagem natural de dentro do seu editor
  • ✅ Validação de esquema simples usando zod
  • 🔒 Usa variáveis de ambiente para manter informações sensíveis seguras

📁 Estrutura do Projeto

/MCP_SERVER │ ├── server.js # Configuração do servidor MCP e ferramenta de calendário ├── .env # Variáveis de ambiente (não commitadas) ├── package.json # Dependências e scripts └── .mcp # Arquivo de configuração MCP

📦 Tecnologias Utilizadas

🚀 Começando

1. Clone o repositório

git clone https://github.com/your-username/mcp-calendar-tool.git
cd mcp-calendar-tool
  1. Instale as dependências npm install
  2. Crie um arquivo .env GOOGLE_API_KEY=sua_chave_da_api_do_google_calendar CALENDAR_ID=seu_id_ou_email_do_calendario
  3. Execute o servidor npm start

Exemplo de Uso (no Cursor)

🛠 Configuração MCP (.mcp)

{ "mcpServers": { "myCalenderData": { "command": "node", "args": ["server.js"], "env": { "GOOGLE_API_KEY": "sua_chave_da_api_aqui", "CALENDAR_ID": "seu_id_do_calendario_aqui" } } } }

🔐 Notas sobre Acesso à API

Certifique-se de que a API do Google Calendar esteja habilitada no seu Google Cloud Console.

O calendário deve ser público ou compartilhado corretamente se estiver usando uma chave de API.

🧭 Melhorias Futuras

Adicionar autenticação OAuth2 para múltiplos usuários

Suportar eventos recorrentes e descrições de eventos

Integrar Google Tasks e lembretes

📄 Licença

Este projeto é open-source e está disponível sob a Licença MIT.

🙋‍♂️ Autor

Pranay Chowdhury Desenvolvedor Frontend | Entusiasta da Stack MERN LinkedIn • GitHub