proactive-mcp — MCP-сервер для Claude Code: Gmail, Calendar
Следит за почтой и календарём по read-only доступам и отдаёт агенту готовые «ситуации»: дедлайн ответа, пересечение встреч, личная дата.
claude mcp add proactive-mcp -- uvx proactive-mcpЧто делает proactive-mcp
Сервер работает в фоне: вотчер синхронизирует Gmail и Google Calendar по минимальным read-only scope, а движок детерминированных правил сравнивает снимки источников с локальной памятью в SQLite. На выходе — не поток уведомлений, а небольшой набор ситуаций с заголовком, объяснением, почему это важно сейчас, ограниченными доказательствами, приоритетом и сроком жизни.
Когда вы просите агента проверить, он вызывает proactive_check и получает эти ситуации, а дальше доставляет их своим каналом. Сам демон агента и LLM не запускает: расписание запусков остаётся за хостом. Внешний текст из писем и календаря считается недоверенным.
Для установки нужны uv, Git и собственный Google Cloud Desktop OAuth client JSON. Пакет 0.2.0 на PyPI ещё без мастера настройки, поэтому в README все команды идут через uvx --from git+https://github.com/madrobotnet/proactive-mcp@7cd0f03243027df464084c3957f03d3c42169268, а голый uvx proactive-mcp подтянет старую версию. После авторизации можно поставить службу вотчера через proactive-mcp service install или запускать демон вручную.
Какие задачи решает
- не пропустить письмо, на которое ждут ответ к сроку
- заметить наложение двух принятых встреч в календаре
- вспомнить о личной дате, которую сохранили в памяти
- дать агенту повод обратиться первым, а не ждать вопроса
- держать данные о ситуациях локально, в SQLite
Примеры запросов агенту
- Проверь
proactive_checkи скажи, есть ли что-то, на что стоит ответить сегодня. - Вызови
proactive_checkи покажи ситуации с высоким приоритетом. - Проверь через
proactive_check, нет ли пересечений встреч на этой неделе.
Как установить proactive-mcp
Командой платформы
claude mcp add proactive-mcp -- uvx proactive-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from proactive-mcp <команда>
Командой платформы
codex mcp add proactive-mcp -- uvx proactive-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from proactive-mcp <команда>
Файл настроек
{
"mcpServers": {
"proactive-mcp": {
"command": "uvx",
"args": [
"proactive-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from proactive-mcp <команда>
Файл настроек
{
"servers": {
"proactive-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"proactive-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from proactive-mcp <команда>
Командой платформы
gemini mcp add proactive-mcp uvx proactive-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from proactive-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о proactive-mcp
Как установить proactive-mcp в Claude Code?
Добавьте сервер командой claude mcp add proactive-mcp -- uvx proactive-mcp. Для полного набора функций (вотчер, память, служба) сначала пройдите setup из README с префиксом uvx --from git+https://github.com/madrobotnet/proactive-mcp@7cd0f03243027df464084c3957f03d3c42169268.
Что делает proactive-mcp?
Превращает read-only письма Gmail и события Google Calendar плюс сохранённую локально память в структурированные ситуации: дедлайн ответа, конфликт встреч, приближающаяся личная дата. Агент получает их через proactive_check и сам решает, когда и как доставить.
Что нужно подготовить до запуска?
Установленные uv и Git, а также свой OAuth client JSON из Google Cloud Desktop и согласие на read-only доступ к Gmail и Calendar. Без этого мастер настройки не пройдёт авторизацию.
