gotifylisted

How to interact with the Gotify self-hosted push notification server via the gotify-mcp MCP tool, CLI binary, or direct REST API. Use this skill whenever the user wants to send a push notification, check notification history, manage Gotify applications or clients, check Gotify server health, delete messages, or do anything with Gotify — even if they just say "send an alert" or "notify me when X is done". Also invoke this when the user asks about notification history, wants to know if their Gotify server is up, or mentions monitoring, alerting, or push notifications in a self-hosted context.
dinglebear-ai/rgotify · ★ 1 · API & Backend · score 67

Install: claude install-skill dinglebear-ai/rgotify

# Gotify — Push Notification Server Gotify is a self-hosted push notification server. The gotify-mcp bridge exposes it as a single MCP tool (`gotify`) with action-based dispatch. A CLI binary and direct REST API are available as fallbacks. ## Token model (critical — read this first) Two tokens, two purposes. Using the wrong token returns 401. | Token | Env var | Starts with | Used for | |-------|---------|-------------|----------| | Client token | `GOTIFY_CLIENT_TOKEN` | `C` | All management: list/create/delete apps, clients, messages; read user | | App token | `GOTIFY_APP_TOKEN` | `A` | **Sending only** — `POST /message` | `health` and `version` need no token at all. --- ## Tier 1 — MCP tool `gotify` (preferred) Single tool, `action` selects the operation. All other parameters are optional unless noted. ### Read actions | Action | Parameters | Notes | |--------|-----------|-------| | `health` | — | No auth required | | `version` | — | No auth required | | `me` | — | Returns current user info | | `messages` | `app_id?`, `limit?` (default 50), `since?` | `since` is a message-ID cursor for pagination | | `applications` | — | Returns array with id, name, defaultPriority, token | | `clients` | — | Returns array with id, name, token | ### Write actions | Action | Required | Optional | |--------|----------|---------| | `send` | `message` | `title`, `priority` (0–10), `extras` (object) | | `create_application` | `name` | `description`, `default_priority` | | `update_appl