notifkit
Self-hosted notification infrastructure for product notifications. One notify() call handles email, SMS, push, etc, with preferences, quiet hours, retries, fall
What is notifkit?
Self-hosted notification infrastructure for product notifications. One notify() call handles email, SMS, push, etc, with preferences, quiet hours, retries, fallback, scheduling, workflows, and delivery logs built in.
Overview of notifkit
What it is
notifkit is a self-hosted notification infrastructure for product notifications. It provides a single notify() API call that handles email, SMS, push notifications, chat messages, and webhooks. It includes built-in features such as user preferences, quiet hours, retries, fallback, scheduling, workflows, an admin dashboard, and delivery logs. It runs on PostgreSQL and Redis. The project is open source under the MIT license.
Key features
- Single API call (notify()) handles multiple channels: push, email, SMS, chat, webhooks.
- Built-in user preferences, consent, quiet hours, retries, deduplication, throttling, template rendering, and delivery tracking.
- Channel fallback: if one channel fails, it automatically tries the next specified channel.
- Workflows defined in TypeScript code, supporting multi-step sequences with delays and event blocking.
- Admin dashboard for live activity feed, delivery logs, queue depth, workflow runs, dead-letter replay, scheduled-send cancellation, and API key management.
- MCP server for AI agent integration (e.g., Claude Code, Cursor).
- Supports multiple projects with separate API keys and data.
Use cases
- Product notifications: order shipped, password reset, OTPs, marketing campaigns.
- Multi-channel notification delivery with fallback (e.g., push then email).
- Scheduled and workflow-based notifications (e.g., wait days, block on events).
- Self-hosted alternative to hosted services like Knock or Courier, avoiding per-message billing.
- Integration with existing PostgreSQL and Redis infrastructure.
Getting started
Requires Node 22+ and Docker. In development, notifkit starts throwaway PostgreSQL and Redis containers.bashnpm create notifkit@latest my-app # or: npx notifkit create my-appcd my-appnpm run dev # leave it runningIn a second terminal:bashnpm run setup # create a project, save its API key to .envnpm run send # send a test notificationThe default provider prints notifications to the server terminal, so no provider account is needed to try it. Pass --provider resend, twilio or fcm to start with a real one.
License and pricing
License: MIT. Open source, no paid edition. The project is self-hosted; costs are whatever your PostgreSQL and Redis infrastructure costs.
Based on the project's public README and repository metadata.