Apple Health MCP Server

MCP сервер для данных Apple Health: агент отвечает на вопросы о сне, тренировках и пульсе запросами SQL

MCP-сервер

Средний риск

Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.

Почему такой уровень

  • Читает чувствительные персональные данные о здоровье
  • Результаты запросов уходят модели вашего MCP-клиента
  • Выполняет сгенерированные запросы SQL по вашей выгрузке
Все причины и проверки

neiltron/apple-health-mcp

Установка

В терминале, через 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

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.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

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

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

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 5b0320d.

Текст для агента

Добавь в конфигурацию 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+ базам

СкиллСредний риск47 тыс.Звезды репозитория
Официальный

Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml

MCP-серверВысокий риск16,5 тыс.Звезды репозитория
Выбор редакции

Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой

СкиллВысокий риск11,1 тыс.Звезды репозитория
Официальный

Язык визуализации для агентов и MCP-сервер: из простой семантической спецификации собираются аккуратные графики

MCP-серверСредний рискБез VPN4,3 тыс.Звезды репозитория
Foxx AIApple Health MCP Server

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.