Apple Health MCP Server
MCP сервер для данных Apple Health: агент отвечает на вопросы о сне, тренировках и пульсе запросами SQL
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Читает чувствительные персональные данные о здоровье
- Результаты запросов уходят модели вашего MCP-клиента
- Выполняет сгенерированные запросы SQL по вашей выгрузке
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/apple-health-mcp-serverОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio --env 'HEALTH_DATA_DIR=<значение HEALTH_DATA_DIR>' apple-health-mcp -- npx -y @neiltron/apple-health-mcp@1.4.5Или добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"apple-health-mcp": {
"command": "npx",
"args": [
"-y",
"@neiltron/apple-health-mcp@1.4.5"
],
"env": {
"HEALTH_DATA_DIR": "<значение HEALTH_DATA_DIR>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
HEALTH_DATA_DIRобязательная- Path to the Apple Health CSV export directory
MAX_MEMORY_MBнеобязательная- Maximum memory usage in megabytes
CACHE_SIZEнеобязательная- Maximum number of cached query results
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"apple-health-mcp": {
"command": "npx",
"args": [
"-y",
"@neiltron/apple-health-mcp@1.4.5"
],
"env": {
"HEALTH_DATA_DIR": "<значение HEALTH_DATA_DIR>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
HEALTH_DATA_DIRобязательная- Path to the Apple Health CSV export directory
MAX_MEMORY_MBнеобязательная- Maximum memory usage in megabytes
CACHE_SIZEнеобязательная- Maximum number of cached query results
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"apple-health-mcp","type":"stdio","command":"npx","args":["-y","@neiltron/apple-health-mcp@1.4.5"],"env":{"HEALTH_DATA_DIR":"<значение HEALTH_DATA_DIR>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"apple-health-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@neiltron/apple-health-mcp@1.4.5"
],
"env": {
"HEALTH_DATA_DIR": "<значение HEALTH_DATA_DIR>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
HEALTH_DATA_DIRобязательная- Path to the Apple Health CSV export directory
MAX_MEMORY_MBнеобязательная- Maximum memory usage in megabytes
CACHE_SIZEнеобязательная- Maximum number of cached query results
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add apple-health-mcp --env 'HEALTH_DATA_DIR=<значение HEALTH_DATA_DIR>' -- npx -y @neiltron/apple-health-mcp@1.4.5Или добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.apple-health-mcp]
command = "npx"
args = ["-y", "@neiltron/apple-health-mcp@1.4.5"]
env = { HEALTH_DATA_DIR = "<значение HEALTH_DATA_DIR>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
HEALTH_DATA_DIRобязательная- Path to the Apple Health CSV export directory
MAX_MEMORY_MBнеобязательная- Maximum memory usage in megabytes
CACHE_SIZEнеобязательная- Maximum number of cached query results
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"apple-health-mcp": {
"command": "npx",
"args": [
"-y",
"@neiltron/apple-health-mcp@1.4.5"
],
"env": {
"HEALTH_DATA_DIR": "<значение HEALTH_DATA_DIR>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
HEALTH_DATA_DIRобязательная- Path to the Apple Health CSV export directory
MAX_MEMORY_MBнеобязательная- Maximum memory usage in megabytes
CACHE_SIZEнеобязательная- Maximum number of cached query results
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"apple-health-mcp": {
"command": "npx",
"args": [
"-y",
"@neiltron/apple-health-mcp@1.4.5"
],
"env": {
"HEALTH_DATA_DIR": "<значение HEALTH_DATA_DIR>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
HEALTH_DATA_DIRобязательная- Path to the Apple Health CSV export directory
MAX_MEMORY_MBнеобязательная- Maximum memory usage in megabytes
CACHE_SIZEнеобязательная- Maximum number of cached query results
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"apple-health-mcp": {
"command": "npx",
"args": [
"-y",
"@neiltron/apple-health-mcp@1.4.5"
],
"env": {
"HEALTH_DATA_DIR": "<значение HEALTH_DATA_DIR>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
HEALTH_DATA_DIRобязательная- Path to the Apple Health CSV export directory
MAX_MEMORY_MBнеобязательная- Maximum memory usage in megabytes
CACHE_SIZEнеобязательная- Maximum number of cached query results
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"apple-health-mcp": {
"command": "npx",
"args": [
"-y",
"@neiltron/apple-health-mcp@1.4.5"
],
"env": {
"HEALTH_DATA_DIR": "<значение HEALTH_DATA_DIR>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
HEALTH_DATA_DIRобязательная- Path to the Apple Health CSV export directory
MAX_MEMORY_MBнеобязательная- Maximum memory usage in megabytes
CACHE_SIZEнеобязательная- Maximum number of cached query results
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"apple-health-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@neiltron/apple-health-mcp@1.4.5"
],
"environment": {
"HEALTH_DATA_DIR": "<значение HEALTH_DATA_DIR>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
HEALTH_DATA_DIRобязательная- Path to the Apple Health CSV export directory
MAX_MEMORY_MBнеобязательная- Maximum memory usage in megabytes
CACHE_SIZEнеобязательная- Maximum number of cached query results
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"apple-health-mcp": {
"command": "npx",
"args": [
"-y",
"@neiltron/apple-health-mcp@1.4.5"
],
"env": {
"HEALTH_DATA_DIR": "<значение HEALTH_DATA_DIR>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
HEALTH_DATA_DIRобязательная- Path to the Apple Health CSV export directory
MAX_MEMORY_MBнеобязательная- Maximum memory usage in megabytes
CACHE_SIZEнеобязательная- Maximum number of cached query results
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"apple-health-mcp": {
"command": "npx",
"args": [
"-y",
"@neiltron/apple-health-mcp@1.4.5"
],
"env": {
"HEALTH_DATA_DIR": "<значение HEALTH_DATA_DIR>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
HEALTH_DATA_DIRобязательная- Path to the Apple Health CSV export directory
MAX_MEMORY_MBнеобязательная- Maximum memory usage in megabytes
CACHE_SIZEнеобязательная- Maximum number of cached query results
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавь в конфигурацию MCP-клиента сервер apple-health: command npx, args -y @neiltron/apple-health-mcp, в env задай HEALTH_DATA_DIR с путем к папке распакованной выгрузки CSV. Нужен Node.js 22 или новее.
Другие способы из описания автора
npx -y @neiltron/apple-health-mcpПеред запуском задайте HEALTH_DATA_DIR с путем к папке выгрузки CSV. Нужен Node.js 22 или новее.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер работает локально с выгрузкой данных Apple Health в формате CSV и выполняет запросы через DuckDB. Он показывает схему таблиц, столбцы и единицы, выполняет один аналитический запрос SELECT с выводом в JSON, CSV или в виде сводки и собирает недельный, месячный или произвольный отчет о здоровье. Данные читаются на месте: сервер не загружает выгрузку в сеть и не делает сетевых запросов, хотя результаты, отданные клиенту, уходят его модели. Доступ к файлам ограничен указанной папкой с данными.
Для кого. Для тех, кто выгружает данные Apple Health и хочет разбирать сон, активность и пульс запросами.
Подходит, если
- Нужно ответить на вопросы по своим данным здоровья за период
- Нужны сводка или отчет по сну, тренировкам и активности
- Нужен разбор данных Apple Health запросами SQL без ручных таблиц
Не подходит, если
- Нет выгрузки Apple Health в формате CSV нужного приложения
- Нужны медицинские выводы: отчеты не заменяют консультацию врача
Пример запроса к агенту
Покажи, как менялся мой сон за последний месяц, и собери короткий отчетОграничения
Нужна выгрузка Apple Health в формате CSV из приложения Simple Health Export CSV, родной формат export.xml пока не поддерживается. Указывается папка с распакованной выгрузкой через HEALTH_DATA_DIR, для запуска нужен Node.js 22 или новее. База DuckDB держится в памяти и пересобирается при каждом запуске, лимит памяти задается через MAX_MEMORY_MB. Сервер выполняет один запрос SELECT за раз, отчеты о здоровье не являются медицинской рекомендацией.
Как отключить. Удалите блок apple-health из конфигурации MCP-клиента и перезапустите его. Данные остаются в вашей папке с выгрузкой и никуда не копируются.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| HEALTH_DATA_DIR обязательная | Путь к папке с распакованной выгрузкой Apple Health в CSV |
| MAX_MEMORY_MB | Лимит памяти DuckDB в мегабайтах, по умолчанию 2048 |
| CACHE_SIZE | Максимальное число кешируемых результатов запросов |
Проверка безопасности
- Читает чувствительные персональные данные о здоровье
- Результаты запросов уходят модели вашего MCP-клиента
- Выполняет сгенерированные запросы SQL по вашей выгрузке
Коротко о README
README описывает локальный сервер, который читает выгрузку Apple Health в формате CSV и выполняет запросы через DuckDB. Перечислены инструменты health_schema, health_query и health_report и настройка Claude Desktop через npx с переменной HEALTH_DATA_DIR. Отдельно разобраны требования: Node.js 22 и выгрузка из приложения Simple Health Export CSV, а также ограничения доступа к файлам и отключение сети внутри DuckDB. Отмечено, что база держится в памяти и пересобирается при каждом запуске, а отчеты не являются медицинской рекомендацией. Лицензия MIT.
Частые вопросы
Как выгрузить данные?
Через приложение Simple Health Export CSV на iPhone: выбрать нужный период, перенести архив на компьютер, распаковать и указать папку в HEALTH_DATA_DIR.
Уходят ли данные в сеть?
Сам сервер не делает сетевых запросов и не загружает выгрузку. Но результаты запросов, которые он отдает клиенту, отправляются модели этого клиента.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой
Язык визуализации для агентов и MCP-сервер: из простой семантической спецификации собираются аккуратные графики