{"id":31161440,"url":"https://github.com/taigrr/gotify-mcp","last_synced_at":"2025-09-19T03:53:17.846Z","repository":{"id":308824350,"uuid":"1024191228","full_name":"taigrr/gotify-mcp","owner":"taigrr","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-08T04:08:25.000Z","size":7,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-08T06:18:25.149Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"0bsd","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/taigrr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"taigrr","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2025-07-22T10:13:33.000Z","updated_at":"2025-08-08T04:08:28.000Z","dependencies_parsed_at":"2025-08-08T06:18:32.864Z","dependency_job_id":null,"html_url":"https://github.com/taigrr/gotify-mcp","commit_stats":null,"previous_names":["taigrr/gotify-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/taigrr/gotify-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taigrr%2Fgotify-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taigrr%2Fgotify-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taigrr%2Fgotify-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taigrr%2Fgotify-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/taigrr","download_url":"https://codeload.github.com/taigrr/gotify-mcp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taigrr%2Fgotify-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275877131,"owners_count":25544466,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-19T02:00:09.700Z","response_time":108,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-19T03:53:13.945Z","updated_at":"2025-09-19T03:53:17.832Z","avatar_url":"https://github.com/taigrr.png","language":"Go","funding_links":["https://github.com/sponsors/taigrr"],"categories":[],"sub_categories":[],"readme":"# gotify-mcp\n\n[![License 0BSD](https://img.shields.io/badge/License-0BSD-pink.svg)](https://opensource.org/licenses/0BSD)\n[![GoDoc](https://godoc.org/github.com/taigrr/gotify-mcp?status.svg)](https://godoc.org/github.com/taigrr/gotify-mcp)\n[![Go Mod](https://img.shields.io/badge/go.mod-v1.23-blue)](go.mod)\n\nA Model Context Protocol (MCP) server that enables LLMs to send notifications to a Gotify server.\nThis allows AI assistants to notify users about task completion, request help, or provide activity summaries.\n\n## Features\n\n- **Send Message**: Send custom messages with configurable priority and title\n- **Ask for Help**: Send help request notifications with context and error details\n- **Notify Completion**: Send task completion notifications with results\n- **Summarize Activity**: Send activity summaries with optional details\n\n## Environment Variables\n\nThe MCP server requires the following environment variables:\n\n- `GOTIFY_URL`: The URL of your Gotify server (e.g., `https://gotify.example.com`)\n- `GOTIFY_TOKEN`: Your Gotify application token for authentication\n\n## Installation\n\n```bash\ngo install github.com/taigrr/gotify-mcp@latest\n```\n\nOr build from source:\n\n```bash\ngit clone https://github.com/taigrr/gotify-mcp.git\ncd gotify-mcp\ngo build -o gotify-mcp\n```\n\n## Usage\n\nThe MCP server communicates over stdio and provides the following tools:\n\n### send-message\nSend a custom message to Gotify.\n\n**Parameters:**\n- `message` (required): The message content to send\n- `title` (optional): Title for the message\n- `priority` (optional): Message priority (0-10, default: 5)\n\n### ask-for-help\nSend a help request notification.\n\n**Parameters:**\n- `context` (required): Context or description of what help is needed\n- `error` (optional): Optional error message or details\n\n### notify-completion\nSend a task completion notification.\n\n**Parameters:**\n- `task` (required): Description of the completed task\n- `result` (optional): Optional result or outcome details\n\n### summarize-activity\nSend an activity summary notification.\n\n**Parameters:**\n- `summary` (required): Summary of activities or current status\n- `details` (optional): Optional additional details\n\n## Integration with MCP Clients\n\nTo use this MCP server with an MCP client, configure it to run the `gotify-mcp` binary with the appropriate environment variables set.\n\nExample configuration for Claude Desktop:\n\n```json\n{\n  \"mcpServers\": {\n    \"gotify\": {\n      \"command\": \"/path/to/gotify-mcp\",\n      \"env\": {\n        \"GOTIFY_URL\": \"https://your-gotify-server.com\",\n        \"GOTIFY_TOKEN\": \"your-application-token\"\n      }\n    }\n  }\n}\n```\n\n## License\n\nThis project is licensed under the 0BSD License, written by [Rob Landley](https://github.com/landley).\nAs such, you may use this library without restriction or attribution, but please don't pass it off as your own.\nAttribution, though not required, is appreciated.\n\nBy contributing, you agree all code submitted also falls under the License.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaigrr%2Fgotify-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftaigrr%2Fgotify-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaigrr%2Fgotify-mcp/lists"}