calendar-mcp — MCP-сервер для Claude Code
Даёт ИИ доступ к Google Calendar: поиск, создание, перенос и удаление событий, проверка занятости и подбор общего времени.
claude mcp add --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --env TOKEN_FILE_PATH=<TOKEN_FILE_PATH> --transport stdio calendar-mcp -- uvx calendar-mcp-serverЧто делает calendar-mcp
calendar-mcp подключает Google Calendar к MCP-клиенту. Сервер ищет календари и события, создаёт и изменяет встречи, переносит их, отправляет RSVP, проверяет занятость и подбирает общий свободный слот с бронированием.
Для расписания есть поиск фокусного времени, анализ загруженности, выявление пересечений между аккаунтами и предложения нового времени встречи. Авторизация проходит через Google OAuth 2.0 для Desktop app, токены хранятся локально и обновляются автоматически. Нужны Google OAuth Client ID и Secret. У HTTP-транспорта пока нет слоя аутентификации, поэтому публичный интерфейс опасен для календаря.
Какие задачи решает
- искать события в Google Calendar
- создавать и переносить встречи
- проверять свободное время нескольких календарей
- находить общий слот и бронировать его
- выделять блоки фокусной работы
Примеры запросов агенту
- Найди свободные интервалы в моём Google Calendar на завтра.
- Подбери общий слот для встречи и забронируй его.
- Найди шесть часов фокусного времени и сначала покажи блоки без создания событий.
Как установить calendar-mcp
Командой платформы
claude mcp add --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --env TOKEN_FILE_PATH=<TOKEN_FILE_PATH> --transport stdio calendar-mcp -- uvx calendar-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from calendar-mcp-server <команда>
Командой платформы
codex mcp add calendar-mcp --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --env TOKEN_FILE_PATH=<TOKEN_FILE_PATH> -- uvx calendar-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from calendar-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"calendar-mcp": {
"command": "uvx",
"args": [
"calendar-mcp-server"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"TOKEN_FILE_PATH": "<TOKEN_FILE_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from calendar-mcp-server <команда>
Файл настроек
{
"servers": {
"calendar-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"calendar-mcp-server"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"TOKEN_FILE_PATH": "<TOKEN_FILE_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from calendar-mcp-server <команда>
Командой платформы
gemini mcp add -e GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> -e GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> -e TOKEN_FILE_PATH=<TOKEN_FILE_PATH> calendar-mcp uvx calendar-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from calendar-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о calendar-mcp
Как установить calendar-mcp в Claude Code?
Задайте Google OAuth Client ID и Secret, затем выполните claude mcp add calendar-mcp -e GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> -e GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> -- uvx calendar-mcp-server. Для сохранения токенов в заданном файле используйте `claude mcp add --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --env TOKEN_FILE_PATH=<TOKEN_FILE_PATH> --transport stdio calendar-mcp -- uvx calendar-mcp-server`.
Что делает calendar-mcp?
Сервер даёт ИИ возможность читать и менять Google Calendar: искать, создавать, обновлять, переносить и удалять события, а также проверять занятость и планировать общие встречи.
Что нужно для работы calendar-mcp?
Нужны Google OAuth Client ID типа Desktop app и Secret, а также включённый Google Calendar API. Для HTTP-режима endpoint нельзя открывать в публичную сеть без отдельной защиты.
