keep-mcp

keep-mcp — MCP-сервер сообщества (автор — feuerdev). Чтение, создание, изменение и удаление заметок Google Keep. Ставится через Docker. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
feuerdev
Лицензия
MIT
Транспорт
stdio
Авторизация
token_env
ОС
Не указана
Языки
python

Уровень риска: high

Мастер-токен Google с полным доступом к аккаунту; изменение и удаление заметок (по умолчанию только своих); скачивание вложений на диск; неофициальный API.

Настройка клиентов

codex
{
    "code": "[mcp_servers.keep_mcp]\ncommand = \"make\"\nargs = [\"-C\", \"/ABSOLUTE/PATH/TO/keep-mcp\", \"start\"]\n\n[mcp_servers.keep_mcp.env]\nGOOGLE_EMAIL = \"you@example.com\"\nGOOGLE_MASTER_TOKEN = \"your-master-token\"\nUNSAFE_MODE = \"false\"",
    "lang": "toml",
    "notes": "Запуск из локальной копии после make install",
    "verified": "docs"
}

Неофициальный проект. keep-mcp работает через библиотеку gkeepapi, которая подключается к Google Keep через неофициальный закрытый API, и требует мастер-токен Google с полным доступом к аккаунту.

Что умеет

keep-mcp — MCP-сервер для Google Keep: ассистент ищет, читает, создаёт и меняет заметки и списки, управляет ярлыками, соавторами и вложениями.

Поиск и чтение. find ищет заметки (по умолчанию без учёта регистра) с фильтрами по ярлыкам, цветам, закреплению, архиву, корзине, датам создания и изменения (ISO 8601, UTC) и лимитом результатов (по умолчанию 50). get_note возвращает заметку по ID.

Создание и изменение. create_note создаёт заметку с заголовком и текстом и автоматически ставит ярлык keep-mcp; create_list создаёт список с флажками; update_note меняет заголовок и текст; add_list_item, update_list_item и delete_list_item работают с пунктами списка.

Состояние заметок. set_note_color (DEFAULT, RED, ORANGE, YELLOW, GREEN, TEAL, BLUE, CERULEAN, PURPLE, PINK, BROWN, GRAY), pin_note, archive_note, trash_note, restore_note и delete_note (пометка на удаление).

Ярлыки, соавторы, медиа. list_labels, create_label, delete_label, add_label_to_note, remove_label_from_note; list_note_collaborators, add_note_collaborator, remove_note_collaborator; list_note_media и download_media — скачивание изображений, рисунков и аудио заметки в локальную папку через авторизованную сессию. По Streamable HTTP скачивание недоступно, потому что файлы попали бы на сервер.

Защита от случайных изменений. По умолчанию все изменяющие и удаляющие операции разрешены только для заметок, созданных самим сервером (с ярлыком keep-mcp). Переменная UNSAFE_MODE со значением true снимает это ограничение.

Кому подойдёт

  • Тем, кто ведёт заметки и списки дел в Google Keep и хочет работать с ними из чата.
  • Тем, кто собирает заметки по ярлыкам и датам — через фильтры find.

Похожие серверы — в категории знания и память.

Установка

Сервер запускается через pipx run keep-mcp или uvx keep-mcp с переменными GOOGLE_EMAIL и GOOGLE_MASTER_TOKEN. Для мастер-токена README описывает способ через браузер: войти на странице accounts.google.com/EmbeddedSetup, нажать «I agree», скопировать cookie oauth_token (начинается с oauth2_4/) и сразу обменять его на токен командой с gpsoauth в Docker или через uv. Токен начинается с aas_et/. Если вместо токена появилась ошибка BadAuthentication, cookie истёк — повторите шаги. Старый способ с паролем или паролем приложения через perform_master_login() README называет ненадёжным.

Для запуска из локальной копии выполните make install один раз, проверьте, что make и uv есть в PATH, и перезапустите клиент после правки конфига. Есть также транспорт Streamable HTTP (keep-mcp --transport streamable-http, по умолчанию 127.0.0.1:8000 с защитой от DNS rebinding) и Dockerfile для контейнера на порту 8000.

Подключение к клиентам

Конфиги приведены дословно из README (запуск из локальной копии). Подробнее — в инструкции как подключить MCP.

[mcp_servers.keep_mcp]
command = "make"
args = ["-C", "/ABSOLUTE/PATH/TO/keep-mcp", "start"]

[mcp_servers.keep_mcp.env]
GOOGLE_EMAIL = "you@example.com"
GOOGLE_MASTER_TOKEN = "your-master-token"
UNSAFE_MODE = "false"

Проверка

Попросите: «Найди мои закреплённые заметки за последнюю неделю» — должен сработать find.

Примеры задач

Создай список покупок: молоко, хлеб, яйца.
Найди заметки с ярлыком «работа» и перенеси старые в архив.

Риски

  • Мастер-токен даёт полный доступ к аккаунту Google. Обращайтесь с ним как с паролем, не коммитьте и никому не передавайте.
  • Изменение и удаление заметок. Не включайте UNSAFE_MODE, если не нужно менять чужие заметки без ярлыка keep-mcp.
  • Запись файлов. download_media сохраняет вложения в локальную папку.
  • HTTP и Docker. Встроенной аутентификации нет: публикуйте только на localhost или за прокси с аутентификацией.
  • Неофициальный API может перестать работать без предупреждения.

Частые вопросы

Нужен ли пароль Google?

Нет, нужен мастер-токен, полученный через браузер.

Может ли сервер удалить мои старые заметки?

По умолчанию — только созданные им самим; иначе нужен UNSAFE_MODE=true.

Что делать с ошибкой DeviceManagementRequiredOrSyncDisabled?

README советует в консоли администратора Google включить режим без управления мобильными устройствами.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Memory

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

cognee-mcp

Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.

Риск: high Лицензия: Apache-2.0 ★ 33 236

Источники