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

Сервер соединяет Google Календарь с Claude, чтобы управлять событиями через обычный разговор. Можно создать встречу, посмотреть расписание, изменить или удалить — всё простыми словами, без ручного ввода. Это избавляет от переключения между окнами и ускоряет работу с календарём для тех, кто привык общаться с ИИ.

Что он умеет?

Сервер работает с Google Календарём: проходит OAuth-авторизацию, открывает браузер для согласия и хранит токены в памяти. Читает события с фильтрами по времени, лимиту и сортировке, используя основной или указанный календарь. Создаёт события с описанием, местом, участниками, напоминаниями, цветом и правилами повторения RFC5545, включая целодневные. Обновляет частично: незаполненные поля сохраняются. Удаляет события по ID.

Каталог MCP
takumi0706/google-calendar-mcp

takumi0706/google-calendar-mcp

от takumi0706

MCP-сервер для интеграции Google Календаря с Claude Desktop. Управляйте событиями через естественный язык: создавайте, редактируйте, удаляйте встречи, настраивайте повторения и цвета. Безопасная ау...

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

README

5 инструментов

Версии

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

Google Calendar MCP Server

Apr-15-2025 12-17-08

🔔 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

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

Инструменты были проиндексированы: 21.10.2026

authenticate

Запускает процесс OAuth для Google Calendar. Открывает окно браузера для получения согласия и сохраняет полученные токены в памяти.

Параметры

Без параметров.

createEvent

Создаёт событие в Google Календаре. Поддерживает события на весь день, участников, напоминания и правила повторения RFC5545.

Параметры

calendarIdstring
eventobjectобязательный

deleteEvent

Удаляет событие из Google Calendar по его event ID.

Параметры

calendarIdstring
eventIdstringобязательный

getEvents

Перечисляет события из Google Календаря в пределах опционального временного диапазона.

Параметры

calendarIdstring | null
Идентификатор календаря (если не указан или пуст, используется основной календарь)
maxResultsinteger
Максимальное количество событий для возврата
orderByenum | string | null
Порядок сортировки возвращаемых событий
timeMaxstring | null
Верхняя граница (исключая) времени начала события в формате ISO 8601
timeMinstring | null
Нижняя граница (включительно) для времени окончания события, в формате ISO 8601

updateEvent

Обновляет существующее событие в Google Calendar. Пропущенные поля сохраняют свои текущие значения.

Параметры

calendarIdstring
eventobjectобязательный
eventIdstringобязательный

`2.0.0`основная	18.08.2026
`1.0.7`	14.07.2025
`1.0.6`	23.04.2025
`1.0.5`	21.04.2025
`1.0.4`	15.04.2025
`1.0.3`	15.04.2025
`1.0.2`	09.04.2025
`1.0.1`	31.03.2025
`1.0.0`	29.03.2025
`0.8.1`	28.03.2025
`0.8.0`	28.03.2025
`0.7.0`	28.03.2025
`0.6.9`	28.03.2025
`0.6.8`	28.03.2025
`0.6.7`	28.03.2025
`0.6.6`	28.03.2025
`0.6.4`	28.03.2025
`0.6.3`	28.03.2025
`0.6.2`	28.03.2025
`0.6.1`	28.03.2025
`0.6.0`	28.03.2025
`0.5.1`	27.03.2025
`0.5.0`	27.03.2025
`0.4.1`	27.03.2025
`0.4.0`	27.03.2025
`0.3.3`	26.03.2025
`0.3.2`	26.03.2025
`0.3.1`	26.03.2025
`0.3.0`	26.03.2025
`0.2.8`	26.03.2025
`0.2.7`	26.03.2025
`0.2.6`	20.03.2025
`0.2.5`	20.03.2025
`0.2.4`	19.03.2025
`0.2.3`	19.03.2025
`0.2.2`	19.03.2025
`0.2.1`	19.03.2025
`0.2.0`	19.03.2025
`0.1.6`	19.03.2025
`0.1.2`	19.03.2025
`0.1.1`	19.03.2025
`0.1.0`	19.03.2025

Выберите клиент, чтобы установить takumi0706/google-calendar-mcp:

Любой клиент

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

{
  "mcpServers": {
    "takumi0706-google-calendar-mcp-6ewwy6gao9": {
      "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"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "takumi0706-google-calendar-mcp-6ewwy6gao9": {
      "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"
      }
    }
  }
}

VS Code

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

{
  "servers": {
    "takumi0706-google-calendar-mcp-6ewwy6gao9": {
      "type": "stdio",
      "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"
      }
    }
  }
}

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

code --add-mcp "{\"name\":\"takumi0706-google-calendar-mcp-6ewwy6gao9\",\"type\":\"stdio\",\"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\"}}"

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": {
    "takumi0706-google-calendar-mcp-6ewwy6gao9": {
      "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"
      }
    }
  }
}

Claude Code

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

claude mcp add takumi0706-google-calendar-mcp-6ewwy6gao9 --env GOOGLE_CLIENT_ID=your_client_id --env GOOGLE_CLIENT_SECRET=your_client_secret --env GOOGLE_REDIRECT_URI=http://localhost:4153/oauth2callback -- npx -y @takumi0706/google-calendar-mcp

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

claude mcp add-json takumi0706-google-calendar-mcp-6ewwy6gao9 "{\"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\"}}"

Codex

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

codex mcp add takumi0706-google-calendar-mcp-6ewwy6gao9 --env GOOGLE_CLIENT_ID=your_client_id --env GOOGLE_CLIENT_SECRET=your_client_secret --env GOOGLE_REDIRECT_URI=http://localhost:4153/oauth2callback -- npx -y @takumi0706/google-calendar-mcp

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

[mcp_servers.takumi0706-google-calendar-mcp-6ewwy6gao9]
command = "npx"
args = ["-y", "@takumi0706/google-calendar-mcp"]

[mcp_servers.takumi0706-google-calendar-mcp-6ewwy6gao9.env]
GOOGLE_CLIENT_ID = "your_client_id"
GOOGLE_CLIENT_SECRET = "your_client_secret"
GOOGLE_REDIRECT_URI = "http://localhost:4153/oauth2callback"

Perplexity

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

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

npx -y @takumi0706/google-calendar-mcp

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

Windsurf

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

{
  "mcpServers": {
    "takumi0706-google-calendar-mcp-6ewwy6gao9": {
      "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"
      }
    }
  }
}

Cline

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

{
  "mcpServers": {
    "takumi0706-google-calendar-mcp-6ewwy6gao9": {
      "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"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

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

mcpServers:
  - name: takumi0706-google-calendar-mcp-6ewwy6gao9
    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

Zed

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

{
  "context_servers": {
    "takumi0706-google-calendar-mcp-6ewwy6gao9": {
      "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"
      }
    }
  }
}

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

{
  "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"
  }
}

Нужен npx

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

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