samsung-health-mcp — MCP-сервер для Claude Code
Читает CSV и ZIP из Samsung Health локально и отдаёт агенту сводки по шагам, сну, пульсу и стрессу. Данные никуда не уходят.
claude mcp add --env SAMSUNG_HEALTH_EXPORT_PATH=<SAMSUNG_HEALTH_EXPORT_PATH> --env SAMSUNG_HEALTH_TIMEZONE=<SAMSUNG_HEALTH_TIMEZONE> --env SAMSUNG_HEALTH_PRIVACY_MODE=<SAMSUNG_HEALTH_PRIVACY_MODE> --env SAMSUNG_HEALTH_WATCH_PATH=<SAMSUNG_HEALTH_WATCH_PATH> --transport stdio samsung-health-mcp -- npx -y samsung-health-mcp-unofficialЧто делает samsung-health-mcp
Сервер разбирает личную выгрузку из приложения Samsung Health: папку с CSV, одиночный файл или архив с CSV внутри. Тип записей определяется по именам файлов и заголовкам, потому что формат выгрузки меняется от версии приложения и устройства. Наружу отдаются только ограниченные сводки и отдельные записи — через MCP-инструменты вроде samsung_health_daily_summary, samsung_health_weekly_summary, samsung_health_data_inventory и samsung_health_connection_status.
Живого облачного API у сервера нет: он не логинится в аккаунт Samsung и не лезет в Health Connect. Поэтому сначала нужно на Android выгрузить данные через «Настройки → Скачать личные данные» и перенести папку на машину. Путь задаётся командой setup --export-path или переменной SAMSUNG_HEALTH_EXPORT_PATH. Проверить конфигурацию можно через doctor.
Обновлять выгрузку вручную не обязательно: setup --watch-path следит за папкой и подхватывает свежий экспорт или *samsung*health*.zip, как только он там появится. Пересканировать можно и по требованию — инструментом samsung_health_reimport. По умолчанию транспорт stdio; запуск с --http поднимает stateless HTTP только на loopback, порт 3000. Проект неофициальный, с Samsung не связан, но лицензия MIT.
Какие задачи решает
- собрать сводку по шагам и сну из своей выгрузки Samsung Health
- посмотреть, какие типы сигналов и за какой период есть в экспорте
- сравнить тренировки и пульс за последнюю неделю
- автоматически обновлять активный экспорт при новой выгрузке
- отдать агенту данные о здоровье без отправки в облако
Примеры запросов агенту
- Проверь состояние подключения через
samsung_health_connection_statusи собери дневную сводку. - Вызови
samsung_health_data_inventory— какие типы данных и диапазоны дат есть в этой выгрузке? - Сделай недельную сводку в JSON и сравни шаги, сон и пульс за последние семь дней.
Как установить samsung-health-mcp
Командой платформы
claude mcp add --env SAMSUNG_HEALTH_EXPORT_PATH=<SAMSUNG_HEALTH_EXPORT_PATH> --env SAMSUNG_HEALTH_TIMEZONE=<SAMSUNG_HEALTH_TIMEZONE> --env SAMSUNG_HEALTH_PRIVACY_MODE=<SAMSUNG_HEALTH_PRIVACY_MODE> --env SAMSUNG_HEALTH_WATCH_PATH=<SAMSUNG_HEALTH_WATCH_PATH> --transport stdio samsung-health-mcp -- npx -y samsung-health-mcp-unofficialВместо <…> подставьте свои значения
Командой платформы
codex mcp add samsung-health-mcp --env SAMSUNG_HEALTH_EXPORT_PATH=<SAMSUNG_HEALTH_EXPORT_PATH> --env SAMSUNG_HEALTH_TIMEZONE=<SAMSUNG_HEALTH_TIMEZONE> --env SAMSUNG_HEALTH_PRIVACY_MODE=<SAMSUNG_HEALTH_PRIVACY_MODE> --env SAMSUNG_HEALTH_WATCH_PATH=<SAMSUNG_HEALTH_WATCH_PATH> -- npx -y samsung-health-mcp-unofficialВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"samsung-health-mcp": {
"command": "npx",
"args": [
"-y",
"samsung-health-mcp-unofficial"
],
"env": {
"SAMSUNG_HEALTH_EXPORT_PATH": "<SAMSUNG_HEALTH_EXPORT_PATH>",
"SAMSUNG_HEALTH_TIMEZONE": "<SAMSUNG_HEALTH_TIMEZONE>",
"SAMSUNG_HEALTH_PRIVACY_MODE": "<SAMSUNG_HEALTH_PRIVACY_MODE>",
"SAMSUNG_HEALTH_WATCH_PATH": "<SAMSUNG_HEALTH_WATCH_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"samsung-health-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"samsung-health-mcp-unofficial"
],
"env": {
"SAMSUNG_HEALTH_EXPORT_PATH": "<SAMSUNG_HEALTH_EXPORT_PATH>",
"SAMSUNG_HEALTH_TIMEZONE": "<SAMSUNG_HEALTH_TIMEZONE>",
"SAMSUNG_HEALTH_PRIVACY_MODE": "<SAMSUNG_HEALTH_PRIVACY_MODE>",
"SAMSUNG_HEALTH_WATCH_PATH": "<SAMSUNG_HEALTH_WATCH_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SAMSUNG_HEALTH_EXPORT_PATH=<SAMSUNG_HEALTH_EXPORT_PATH> -e SAMSUNG_HEALTH_TIMEZONE=<SAMSUNG_HEALTH_TIMEZONE> -e SAMSUNG_HEALTH_PRIVACY_MODE=<SAMSUNG_HEALTH_PRIVACY_MODE> -e SAMSUNG_HEALTH_WATCH_PATH=<SAMSUNG_HEALTH_WATCH_PATH> samsung-health-mcp npx -y samsung-health-mcp-unofficialВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о samsung-health-mcp
Как установить samsung-health-mcp в Claude Code?
Добавьте сервер командой claude mcp add samsung-health-mcp -- npx -y samsung-health-mcp-unofficial. Если нужны путь к экспорту, часовой пояс и режим приватности, используйте вариант с --env и --transport stdio.
Что делает samsung-health-mcp?
Читает локальную выгрузку Samsung Health в формате CSV или ZIP и отдаёт агенту сводки и отдельные записи по активности, сну, сердцу и стрессу через MCP-инструменты.
Нужен ли аккаунт Samsung или доступ к облаку?
Нет. Сервер работает только с файлами, которые вы сами выгрузили из приложения; логина, OAuth и облачного прокси у него нет.
