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.
Настройка клиентов
{
"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
Эталонный сервер постоянной памяти на основе графа знаний.
Context7
Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.
hindsight
Долговременная память для ИИ-агентов по образцу человеческой.
cognee-mcp
Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.