Для чего этот сервер?

Этот MCP-сервер связывает Google Календарь с AI-ассистентами. Он позволяет управлять событиями, проверять занятость в нескольких календарях сразу и создавать встречи по описанию. Сервер решает проблему ручного переноса задач из чата в календарь — ассистент делает всё сам, включая поиск свободных окон и импорт дат из картинок и PDF.

Каталог MCP
Google Calendar MCP

Google Calendar MCP

от nspady

Управляет Google Calendar: создаёт и редактирует события, находит пересечения и свободные окна, импортирует встречи из изображений и ссылок.

Github NPM Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

Google Calendar MCP Server

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

I also built Cocal, the calendar integration I wanted for chat: a visual calendar inside Claude that shows your whole day around a proposed time, plus booking links and invites you manage from the conversation. It's hosted, so it works on desktop and mobile with no Google Cloud setup.

_{Real Cocal UI with sample calendar data. Click either screenshot to enlarge.}

Try Cocal →

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

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

`2.7.0`основная	29.09.2026
`2.6.3`	03.09.2026
`2.6.2`	01.06.2026
`2.6.1`	02.03.2026
`2.6.0`	02.03.2026
`2.4.1`	18.01.2026
`2.4.0`	18.01.2026
`2.3.1`	06.01.2026
`2.3.0`	06.01.2026
`2.2.0`	08.12.2025
`2.1.0`	06.12.2025
`2.0.7`	05.11.2025
`2.0.6`	22.10.2025
`2.0.5`	19.10.2025
`2.0.4`	15.10.2025
`2.0.2`	14.10.2025
`2.0.1`	11.10.2025
`2.0.0`	11.10.2025
`1.4.9`	02.09.2025
`1.4.8`	03.07.2025
`1.4.6`	18.06.2025
`1.4.5`	17.06.2025
`1.4.4`	17.06.2025
`1.4.3`	17.06.2025
`1.4.2`	17.06.2025
`1.4.0`	17.06.2025
`1.3.0`	05.06.2025
`1.2.0-beta.3`	05.06.2025
`1.2.0-beta.2`	05.06.2025
`1.2.0-beta.1`	05.06.2025
`1.2.0-beta.0`	05.06.2025

Выберите клиент, чтобы установить Google Calendar MCP:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

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

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"google-calendar-mcp-n8lb\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"@cocal/google-calendar-mcp\"],\"env\":{\"GOOGLE_OAUTH_CREDENTIALS\":\"/path/to/your/gcp-oauth.keys.json\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

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

Впишите сервер и полностью перезапустите Claude Desktop:

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

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add google-calendar-mcp-n8lb --env GOOGLE_OAUTH_CREDENTIALS=/path/to/your/gcp-oauth.keys.json -- npx @cocal/google-calendar-mcp

Либо через JSON-конфиг:

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

Codex

Добавьте сервер командой в терминале:

codex mcp add google-calendar-mcp-n8lb --env GOOGLE_OAUTH_CREDENTIALS=/path/to/your/gcp-oauth.keys.json -- npx @cocal/google-calendar-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.google-calendar-mcp-n8lb]
command = "npx"
args = ["@cocal/google-calendar-mcp"]

[mcp_servers.google-calendar-mcp-n8lb.env]
GOOGLE_OAUTH_CREDENTIALS = "/path/to/your/gcp-oauth.keys.json"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите Google Calendar MCP, а в поле команды запуска — строку ниже:

npx @cocal/google-calendar-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

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

Continue

Создайте файл в .continue/mcpServers/ (например google-calendar-mcp-n8lb.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: google-calendar-mcp-n8lb
    command: npx
    args:
      - "@cocal/google-calendar-mcp"
    env:
      GOOGLE_OAUTH_CREDENTIALS: /path/to/your/gcp-oauth.keys.json

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx