takumi0706/google-calendar-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

59 stars 11 forks Качество 80 Тренд 21MIT

Repository Install

MCP-сервер Google Calendar для интеграции с Claude Desktop

Обзор

Версия 2.0.0 переходит к пересмотру протокола MCP 2026-07-28 и реализует PKCE по потоку OAuth. Это требует. Смотрите историю версий ниже для полного списка изменений. Google Calendar MCP Server - это реализация сервера MCP (Model Context Protocol), которая обеспечивает интеграцию между Google Calendar и Claude Desktop. Этот проект позволяет Клоду взаимодействовать с пользовательским календарем Google, предоставляя возможность отображать, создавать, обновлять и удалять события календаря посредством взаимодействия на естественном языке.

Обзор (машинный перевод)

*** Обновленное уведомление ** Версия 2.0.0 переходит к пересмотру протокола MCP 2026-07-28 и реализует PKCE в потоке OAuth. Для этого требуется Node.js 20 или новее. Смотрите историю версий ниже для полного списка изменений.

Обзор проекта

Google Calendar MCP Server - это реализация сервера MCP (Model Context Protocol), которая обеспечивает интеграцию между Google Calendar и Claude Desktop. Этот проект позволяет Клоду взаимодействовать с пользовательским календарем Google, предоставляя возможность отображать, создавать, обновлять и удалять события календаря посредством взаимодействия на естественном языке.

Основные характеристики

Интеграция с календарем Google Предоставляет мост между Claude Desktop и Google Calendar API Реализация МСП: Соответствует спецификации Model Context Protocol для интеграции инструментов помощника ИИ Аутентификация OAuth2 Безопасно обрабатывает поток аутентификации Google API ** Управление событиями**: Поддерживает всесторонние операции календарных событий (получать, создавать, обновлять, удалять) ** Поддержка цвета**: Возможность установки и обновления цветов событий с использованием параметра colorId -СТДИО транспорт: Использование стандартного ввода/вывода для связи с Claude Desktop

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Google Calendar MCP Server

🔔 VERSION UPDATE NOTICE 🔔
Version 2.0.0 moves to MCP protocol revision 2026-07-28 and implements PKCE on the OAuth flow. It requires Node.js 20 or newer. See the version history below for the full list of changes.

Project Overview

Google Calendar MCP Server is an MCP (Model Context Protocol) server implementation that enables integration between Google Calendar and Claude Desktop. This project enables Claude to interact with the user’s Google Calendar, providing the ability to display, create, update, and delete calendar events through natural language interaction.

Core Features

Google Calendar integration: Provides a bridge between Claude Desktop and the Google Calendar API
MCP implementation: Follows the Model Context Protocol specification for AI assistant tool integration
OAuth2 authentication: Handles the Google API authentication flow securely
Event management: Supports comprehensive calendar event operations (get, create, update, delete)
Color support: Ability to set and update event colors using colorId parameter
STDIO transport: Uses standard input/output for communication with Claude Desktop

Technical Architecture

This project uses:

TypeScript: For type-safe code development
MCP SDK: Uses @modelcontextprotocol/server v2 (protocol revision 2026-07-28, with the 2025 revisions still served for older clients)
Google API: Uses googleapis for Google Calendar API access
Hono: Lightweight and fast web framework for the authentication server
google-auth-library: Drives the OAuth2 authorization code flow with PKCE (S256)
Zod: Implements schema validation for request/response data
Environment-based configuration: Uses dotenv for configuration management
AES-256-GCM: For token encryption using Node.js crypto module
Open: For automatic browser launching during authentication
Readline: For manual authentication input in server environments
Jest: For unit testing and coverage
GitHub Actions: For CI/CD

Main Components

MCP Server: Core server implementation that handles communication with Claude Desktop
Google Calendar Tools: Calendar operations (retrieval, creation, update, deletion)
Authentication Handler: Management of OAuth2 flow with Google API
Schema Validation: Ensuring data integrity in all operations
Token Manager: Secure handling of authentication tokens

Available Tools

Открыть полный README на GitHub

Установка

npx -y @takumi0706/google-calendar-mcp

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@takumi0706/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id",
        "GOOGLE_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_REDIRECT_URI": "http://localhost:4153/oauth2callback"
      }
    }
  }
}