notifyd — Claude Code MCP server: run your notification instance
Gives the agent operator tools for a self-hosted notifyd: digest, jobs, retries, suppressions, test sends. Useful when the instance has no admin UI.
Open on GitHubWhat notifyd does
The server hooks your assistant to a running notifyd over HTTP at https://{notifyd_host}/mcp. Nothing else to install on the client side.
What the agent gets is the on-call operator's to-do list. A digest call returns findings, each with the action to take. From there it can list jobs by status, channel or project, open one job to see the provider and attempts, and re-queue a failed send once the cause is fixed. Suppressions, project settings and test sends are exposed the same way. notifyd itself owns the queue, priorities, retries and provider failover.
You need an instance up and reachable. PostgreSQL is its only dependency. The agent talks to the instance with its key, so think about which environment you hand it and whether that access should be scoped.
What it helps with
- see what needs attention across the instance in one call
- list failed jobs filtered by channel or project
- re-queue a job after the underlying issue is fixed
- fire a test send to your own address
- work through suppressions and project settings
Example prompts for the agent
- Show me the notifyd digest for the last day
- List failed email jobs and retry them
- Send a test email to [email protected] for the myapp project
How to install notifyd
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http notifyd https://{notifyd_host}/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add notifyd --url https://{notifyd_host}/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"notifyd": {
"url": "https://{notifyd_host}/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"notifyd": {
"type": "http",
"url": "https://{notifyd_host}/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http notifyd https://{notifyd_host}/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about notifyd
How do I install notifyd in Claude Code?
Run claude mcp add --transport http notifyd https://{notifyd_host}/mcp with your instance host in place of the placeholder.
What does notifyd do?
It turns instance operations into MCP tools: the digest with suggested actions, job inspection and retries, suppressions, projects, test sends.
What do I need for it to work?
A running notifyd instance exposing /mcp, plus PostgreSQL. The server depends on PostgreSQL alone, with no Redis or message broker.
