repowisebinwiederhier/ntfy

binwiederhier / ntfy

Send push notifications to your phone or desktop using PUT/POST

Go★ 34,970
Use in your agentAsk this codebase

github.com/binwiederhier/ntfyIndexed at 5e11f4fUp to date with upstream

What is ntfy?

ntfy is a simple HTTP-based pub-sub notification service for sending push notifications to phones or desktops through PUT or POST requests. It lets scripts send notifications from computers without requiring an account or fees, and it can be self-hosted as open-source software. ntfy is primarily written in Go, with JavaScript and other supporting languages.

Written by a model from the README and the source

463 files and 4,835 symbols in 27 modules, led by Go (244 files) and JavaScript (88).

Start reading

Code health

7.5out of 10Good

This codebase scores 7.5 out of 10 for code health, which we rate good. It also scores maintainability 8.0 and static performance 9.5 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 46 of 463 files are git hotspots, and they average 6.2 — which is where the fixes pay off most.

Full health report

On the leaderboards:#3 of 22 Go repos

Use binwiederhier/ntfy in your agent

Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.

  1. 1.In Claude, open Customize → Connectors, click +, then Add custom connector. On a Team or Enterprise plan an owner adds it first under Organization settings → Connectors.
  2. 2.Paste the server URL below as the Remote MCP server URL, then click Add.
  3. 3.Click Connect. A Repowise sign-in window opens. Approve access.
  4. 4.Repowise's tools are now available in your Claude chats.

Connect with one click. Sign in with Repowise (OAuth), no API key to copy. Works in Claude on the web, desktop, and mobile.

Docs
bash
https://api.repowise.dev/mcp/binwiederhier/ntfy
Editors need an API key: sign in to create one.Sign in to connect

This repo is public, so anyone with a Repowise account and an API key can connect.

Try asking

  • get_overview()
  • get_answer("how is ntfy put together?")
  • get_why("why is ntfy structured this way?")

Explore ntfy

Key features of ntfy

  • ntfy sends push notifications to phones or desktops through PUT or POST requests.
  • ntfy lets scripts send notifications from any computer.
  • ntfy provides an HTTP-based pub-sub notification service.
  • ntfy can be run as a self-hosted open-source service.
  • ntfy provides open-source Android and iOS apps.

How binwiederhier/ntfy works

Input enters ntfy through HTTP PUT or POST requests handled by the service. main.go starts the application, while cmd/app.go provides application command handling. server/server.go implements the notification service and connects request processing with delivery. The message directory manages notification data, including message/cache.go for message caching. The user directory manages user-related operations through user/manager.go, while the web directory provides the web application. Notifications can be delivered to phones or desktops through the service.

The codebase has 463 files and 4,835 symbols in 27 modules, led by Go, JavaScript and Shell. Code health is 7.5 out of 10, rated good.

binwiederhier/ntfy FAQ

What is ntfy?

ntfy is an HTTP-based pub-sub notification service for sending push notifications to phones or desktops. Scripts can publish notifications through PUT or POST requests.

How does ntfy work?

ntfy accepts PUT or POST requests and publishes the resulting notifications to subscribed phones or desktops. The Go service handles requests, messages, users, and web functionality.

What language is ntfy written in?

ntfy is primarily written in Go. The repository also includes JavaScript, shell, Python, PHP, and Dockerfile files.

How is the ntfy code organized?

ntfy organizes its code into modules including web, server, util, cmd, cluster, db, message, and user. main.go and cmd/app.go are application entry points, while server/server.go implements the service.

Who is ntfy for?

ntfy is for people who want to send notifications to phones or desktops from scripts. It also supports people who want to run their own notification service.

What license does ntfy use?

ntfy uses the Apache-2.0 license.

The summary, features and answers on this page are written by a model from the README and the source, and refreshed with each index.

About this page

Get a page like this for your own codebase

Repowise built this map of binwiederhier/ntfy from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Index your repo freeSee how Repowise worksFree for 2 public repos, with a page like this one.

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.