NG

nspady/google-calendar-mcp

Developer tools

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

1,2 тыс. stars 336 forks Качество 87 Тренд 43MIT

Интеграция с MCP для Google Calendar для управления событиями.

Обзор

Сервер Model Context Protocol (MCP), который обеспечивает интеграцию Google Calendar для AI-ассистентов, таких как Claude. - : Подключить несколько аккаунтов Google (например, рабочий, личный) и одновременно запросить их - : Перечислить события из нескольких календарей в одном запросе - : Обнаружить перекрывающиеся события в любой комбинации календарей - : Создание, обновление, удаление и поиск событий календаря - : Расширенные возможности модификации для повторяющихся событий - : Проверка доступности между календарями - : Понимание дат и времени на естественном языке - : Добавление событий календаря из изображений, PDF или веб-ссылок 1. Проект Google Cloud с включённым Calendar API 2. Учетные данные OAuth 2.0 (тип десктопного приложения) 1. Зайдите в Google Cloud Console 2. Создайте новый проект или выберите существующий. 3. Включите API Google Calendar для вашего проекта. Убедитесь, что выбран правильный проект в верхней панели перед включением API. 4. Создайте OAuth 2.

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

Сервер Model Context Protocol (MCP), который обеспечивает интеграцию Google Calendar для AI-ассистентов, таких как Claude.

Я также создал Cocal — интеграцию календаря для чата: визуальный календарь внутри Claude, который показывает весь ваш день примерно по предложенному времени, плюс ссылки на бронирование и приглашения, которыми вы управляете из беседы. Он размещён, поэтому работает как на десктопе, так и на мобильном устройстве без Google Cloud.

Настоящий интерфейс Cocal с примерами календарных данных. Нажмите на любой из скриншотов для увеличения.
Попробуйте Cocal →


Особенности

  • Поддержка нескольких аккаунтов: Подключите несколько аккаунтов Google (например, рабочие, личные) и одновременно отправляйте к ним запросы
  • Multi-calendar Support: Список событий из нескольких календарей в одном запросе
  • Конфликты между аккаунтами: Обнаружение перекрывающихся событий в любой комбинации календарей
  • Управление событиями: Создание, обновление, удаление и поиск событий календаря
  • Повторяющиеся события: Расширенные возможности модификации для повторяющихся событий
  • Бесплатные/занятые запросы: проверьте доступность в календарях
  • Умное расписание: Понимание дат и времени на естественном языке
  • Интеллектуальный импорт: Добавление событий календаря из изображений, PDF или веб-ссылок

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

README

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

Google Calendar MCP Server

A Model Context Protocol (MCP) server that provides Google Calendar integration for AI assistants like Claude.


Features

  • Multi-Account Support: Connect multiple Google accounts (e.g., work, personal) and query them simultaneously
  • Multi-Calendar Support: List events from multiple calendars in a single request
  • Cross-Account Conflicts: Detect overlapping events across any combination of calendars
  • Event Management: Create, update, delete, and search calendar events
  • Recurring Events: Advanced modification capabilities for recurring events
  • Free/Busy Queries: Check availability across calendars
  • Smart Scheduling: Natural language understanding for dates and times
  • Intelligent Import: Add calendar events from images, PDFs, or web links

Quick Start

Don’t want to set up a Google Cloud project? Cocal is a hosted option that works in Claude on desktop and mobile.

Prerequisites

  1. A Google Cloud project with the Calendar API enabled
  2. OAuth 2.0 credentials (Desktop app type)

Google Cloud Setup

  1. Go to the Google Cloud Console
  2. Create a new project or select an existing one.
  3. Enable the Google Calendar API for your project. Ensure that the right project is selected from the top bar before enabling the API.
  4. Create OAuth 2.0 credentials:
    • Go to Credentials
    • Click “Create Credentials” > “OAuth client ID”
Открыть полный README на GitHub

Установка

npx @cocal/google-calendar-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

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

{ "mcpServers": { "google-calendar": { "command": "npx", "args": ["@cocal/google-calendar-mcp"], "env": { "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json" } } } }