kcofoni/gotify-mcp repository overview

⁠Gotify MCP Server

Short Description (for Docker Hub overview):

MCP server enabling Claude AI to interact with Gotify notifications via SSE/HTTP transport.

Full Description:

A Model Context Protocol (MCP) server for Gotify that enables Claude AI to interact with your Gotify notifications directly.

⁠Features

• 📨 Create and manage Gotify messages
• 📥 Retrieve messages from all applications
• 🔧 Manage Gotify applications and clients
• 🏥 Health monitoring endpoints
• 🔌 SSE and HTTP transport support

⁠Quick Start

⁠Prerequisites

Create the required Docker network:

docker network create jakenet

⁠Docker Compose

version: '3.8'

services:
  gotify-mcp:
    image: kcofoni/gotify-mcp:latest
    container_name: gotify-mcp
    ports:
      - "3020:3020"
    environment:
      - GOTIFY_URL=https://your-gotify-instance.com
      - GOTIFY_CLIENT_TOKEN=your_client_token
      - GOTIFY_APP_TOKEN=your_app_token
      - GOTIFY_MCP_PORT=3020
      - GOTIFY_MCP_TRANSPORT=sse
    networks:
      - jakenet
    restart: unless-stopped

networks:
  jakenet:
    external: true

⁠Environment Variables

⁠Getting Gotify Tokens

1. Client Token: Gotify UI → Clients → Create Client
2. App Token: Gotify UI → Apps → Create Application

⁠Claude Code Integration

Add to your ~/.claude.json:

{
  "mcpServers": {
    "gotify": {
      "type": "sse",
      "url": "http://localhost:3020/mcp"
    }
  }
}

Then reload VSCode: Ctrl+Shift+P → "Developer: Reload Window"

⁠Health Check

curl http://localhost:3020/health

Expected response:

{
  "status": "healthy",
  "gotify_accessible": true
}

⁠Available MCP Tools

• create_message - Send notifications to Gotify
• get_messages - Retrieve messages
• delete_message - Delete specific messages
• delete_all_messages - Clear all messages
• create_application - Create Gotify apps
• get_applications - List applications
• update_application - Update app settings
• delete_application - Remove applications
• create_client - Create Gotify clients
• get_clients - List clients
• get_health - Server health status
• get_version - Gotify version info

⁠Tags

• latest - Most recent build
• v1.0.0 - Stable release

⁠Links

• Source Code: github.com/jmagar/gotify-mcp⁠
• Gotify: gotify.net⁠
• MCP Protocol: modelcontextprotocol.io⁠
• Claude Code: claude.ai/claude-code⁠

⁠License

Based on jmagar/gotify-mcp⁠