ntfy-mcp-server — MCP-сервер Claude Code: что делает и как установить
MCP-сервер для отправки пуш-уведомлений через ntfy на телефон или рабочий стол. Позволяет ассистенту оповещать о завершении задач, читать историю сообщений и удалять уведомления.
claude mcp add --env NTFY_SERVERS=<NTFY_SERVERS> --env NTFY_BASE_URL=<NTFY_BASE_URL> --env NTFY_DEFAULT_TOPIC=<NTFY_DEFAULT_TOPIC> --env NTFY_AUTH_TOKEN=<NTFY_AUTH_TOKEN> --env NTFY_AUTH_USERNAME=<NTFY_AUTH_USERNAME> --transport stdio ntfy-mcp-server -- npx -y ntfy-mcp-serverЧто делает ntfy-mcp-server
Сервер предоставляет четыре инструмента: публикацию сообщений в топик ntfy, очистку или удаление уведомлений по их идентификатору, чтение истории и поиск тегов с эмодзи. Также доступен ресурс ntfy://{topic} с последними двадцатью сообщениями за прошедший час. Для работы с публичным сервисом ntfy.sh не требуется сложной настройки.
При публикации поддерживаются уровни важности от 1 до 5, кликабельные ссылки, вложения, иконки и кнопки действий. Тело сообщения ограничено размером 4096 байт. Если текст не передан, сервер подставит значение по умолчанию.
Топик создаётся автоматически при первой отправке. Любой знающий его название может слать и читать оповещения, поэтому имя темы нужно держать в секрете. Действия вроде удаления сообщений или отправки писем сервер всегда согласует с пользователем перед выполнением.
Какие задачи решает
- отправить пуш на телефон после завершения длинного скрипта
- проверить последние сообщения и оповещения в топике ntfy
- отозвать или скрыть отправленное уведомление по его номеру
- подобрать эмодзи для тегов пуш-сообщения
Примеры запросов агенту
- Отправь в топик deploy-alerts пуш о завершении сборки с приоритетом 4
- Проверь последние уведомления в топике dev-ci за последние 30 минут
- Удали пуш-уведомление с sequence_id 1042 из топика servers
Как установить ntfy-mcp-server
Командой платформы
claude mcp add --env NTFY_SERVERS=<NTFY_SERVERS> --env NTFY_BASE_URL=<NTFY_BASE_URL> --env NTFY_DEFAULT_TOPIC=<NTFY_DEFAULT_TOPIC> --env NTFY_AUTH_TOKEN=<NTFY_AUTH_TOKEN> --env NTFY_AUTH_USERNAME=<NTFY_AUTH_USERNAME> --transport stdio ntfy-mcp-server -- npx -y ntfy-mcp-serverВместо <…> подставьте свои значения. Ещё 15 переменных окружения — в README сервера
Командой платформы
codex mcp add ntfy-mcp-server --env NTFY_SERVERS=<NTFY_SERVERS> --env NTFY_BASE_URL=<NTFY_BASE_URL> --env NTFY_DEFAULT_TOPIC=<NTFY_DEFAULT_TOPIC> --env NTFY_AUTH_TOKEN=<NTFY_AUTH_TOKEN> --env NTFY_AUTH_USERNAME=<NTFY_AUTH_USERNAME> -- npx -y ntfy-mcp-serverВместо <…> подставьте свои значения. Ещё 15 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"ntfy-mcp-server": {
"command": "npx",
"args": [
"-y",
"ntfy-mcp-server"
],
"env": {
"NTFY_SERVERS": "<NTFY_SERVERS>",
"NTFY_BASE_URL": "<NTFY_BASE_URL>",
"NTFY_DEFAULT_TOPIC": "<NTFY_DEFAULT_TOPIC>",
"NTFY_AUTH_TOKEN": "<NTFY_AUTH_TOKEN>",
"NTFY_AUTH_USERNAME": "<NTFY_AUTH_USERNAME>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 15 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"ntfy-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ntfy-mcp-server"
],
"env": {
"NTFY_SERVERS": "<NTFY_SERVERS>",
"NTFY_BASE_URL": "<NTFY_BASE_URL>",
"NTFY_DEFAULT_TOPIC": "<NTFY_DEFAULT_TOPIC>",
"NTFY_AUTH_TOKEN": "<NTFY_AUTH_TOKEN>",
"NTFY_AUTH_USERNAME": "<NTFY_AUTH_USERNAME>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 15 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e NTFY_SERVERS=<NTFY_SERVERS> -e NTFY_BASE_URL=<NTFY_BASE_URL> -e NTFY_DEFAULT_TOPIC=<NTFY_DEFAULT_TOPIC> -e NTFY_AUTH_TOKEN=<NTFY_AUTH_TOKEN> -e NTFY_AUTH_USERNAME=<NTFY_AUTH_USERNAME> ntfy-mcp-server npx -y ntfy-mcp-serverВместо <…> подставьте свои значения. Ещё 15 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ntfy-mcp-server
Как установить ntfy-mcp-server в Claude Code?
Выполните в терминале команду claude mcp add ntfy-mcp-server -- npx -y ntfy-mcp-server. Для передачи ключей авторизации и адреса своего сервера добавьте нужные переменные через флаги --env.
Зачем нужен ntfy-mcp-server?
Он связывает ИИ-ассистента с сервисом ntfy. Это даёт агенту возможность присылать уведомления на телефон, контролировать доставку и опрашивать ленту событий.
Требует ли сервер подтверждения действий?
Да. Перед удалением сообщений, очисткой или отправкой пушей с внешними кнопками и вызовами сервер запрашивает согласие пользователя.
