A notification that says "Build Complete" is ambiguous the moment you have two projects open. Because the subtitle is filled from the current project, three agents in three checkouts produce three distinguishable alerts with no per-project configuration. The log file is the quiet second feature: notifications you missed are still on disk in JSON, so "what did it try to tell me at 3am" has an answer.
A small MCP server that sends real macOS system notifications through `osascript`. It exists for the case where the assistant is working and you are not watching: the build finishes, the agent needs an answer, and a notification lands in Notification Center rather than scrolling past in a terminal.
- A native notification with a title and message, typed as `success`, `error`, `info` or `warning`, with sound on by default — `notify`
- The current project name detected and used as the subtitle automatically, so several agents in several checkouts stay distinguishable without configuring anything
- A subtitle override when the automatic project name is not what you want
- Every notification appended to `~/.mcp-notifications.log` in JSON with timestamp, project, type, title, message and any error — an audit trail of what the agent tried to tell you while you were away
macOS, since notifications go through the native `osascript`. Node.js 20+ and TypeScript 5.5+. There is no published package: clone the repository and run the bundled `install.sh`, which installs dependencies, builds, and writes an example config; then point your client at `dist/index.js` by absolute path. No account, no key, no network.