Google Calendar MCP

Google Calendar MCP

Visão geral

Este é um servidor MCP stdio que se integra ao Google Calendar. Você pode consultar, criar e visualizar detalhes de eventos via protocolo MCP em ferramentas como o Cursor. A autenticação usa Google OAuth2.

Principais recursos

• Integração com a API do Google Calendar
• Fornece funcionalidades de consulta, criação e visualização de detalhes de eventos via servidor MCP stdio
• Tratamento de autenticação Google OAuth2

---

Pilha de tecnologia

• Python 3.13 ou superior (recomendado: 3.13.3)
• Gerenciador de pacotes: uv
• Servidor MCP: fastmcp
• Integração com Google API: google-api-python-client, google-auth, google-auth-oauthlib
• Autenticação: OAuth2 (Google)

---

Funcionalidades implementadas e métodos MCP

Funcionalidade	Método MCP	Descrição
Visualizar eventos do mês	list_month_events	Consulta a lista de todos os eventos do ano/mês especificado
Visualizar eventos de uma data específica	list_day_events	Consulta a lista de todos os eventos da data especificada
Visualizar detalhes do evento	get_event_detail	Consulta informações detalhadas pelo ID do evento
Registrar evento	create_event	Cria um novo evento (possível adicionar participantes (e-mail))
Editar evento	update_event	Modifica informações do evento pelo ID (título, horário, etc.)
Excluir evento	delete_event	Exclui o evento pelo ID
Encontrar horários livres	find_free_slots	Encontra intervalos livres de N minutos ou mais em uma data específica (útil para agendar reuniões)

---

1. Instalação do uv (apenas na primeira vez)

macOS/Homebrew

brew install uv

ou script de instalação oficial

curl -Ls https://astral.sh/uv/install.sh | sh

Windows (PowerShell)

iwr -useb https://astral.sh/uv/install.ps1 | iex

2. Download do pacote MCP

git clone https://github.com/AnByoungHyun/google_calendar_mcp.git
cd google_calendar_mcp

3. Instalação dos pacotes

uv sync

• Todos os pacotes são instalados automaticamente com o comando acima.

4. Exemplo de registro no Cursor MCP

Exemplo de .cursor/mcp.json:

{
  "mcpServers": {
    ...
    "google-calendar": {
      "command": "uv",
      "args": ["--directory", "<google_calendar_mcp_path>", "run", "google_calendar_mcp"]
    }
  }
}

---

Referências e contato

• Documentação oficial da API do Google Calendar: https://developers.google.com/calendar/api
• Documentação do MCP/fastmcp: https://github.com/anysphere/fastmcp

Não são necessários comandos de ambiente virtual/venv separados. O uv cria automaticamente um ambiente seguro. Se tiver dúvidas durante a instalação/execução, entre em contato a qualquer momento!