Gotify MCP server
Commit Nov 14, 2026Enables AI assistants to send push notifications, help requests, and activity summaries to a Gotify server.
Also known as taigrr/gotify-mcp
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 14, 2026
- License
- 0BSD
What is Gotify MCP?
Gotify enables AI assistants to send push notifications, help requests, and activity summaries to a Gotify server.
Summary generated from the project's README
About Gotify MCP server
Sending push notifications and status updates from an AI assistant to your Gotify server is what this MCP server enables. It allows large language models to communicate directly with your notification infrastructure, providing a way for agents to alert you when they finish a job or encounter an issue that requires human intervention.
Developers set this up by providing a GOTIFY_URL and a GOTIFY_TOKEN via environment variables. The server operates over stdio, making it compatible with MCP clients like Claude Desktop. Once configured, the assistant can use specific tools to manage communication.
The server provides four distinct tools for different notification needs. You can use send-message to dispatch custom text or markdown content with a priority level between 0 and 10. The ask-for-help tool allows the AI to request assistance by providing context and error details, while notify-completion and summarize-activity tools help report task outcomes and general status updates.
What you can do with it
- 1Requesting human assistanceAsk the AI to notify you when it encounters an error that requires your manual input.
- 2Reporting task resultsHave the assistant send a notification once a long-running process or task is finished.
- 3Dispatching custom alertsInstruct the AI to send a specific message with a custom title and priority level.
- 4Providing status updatesRequest a summary of all recent activities or the current state of a project.
Written from the project's README. Every use case is checked against a quote from it.
Configuration
GOTIFY_TOKENGOTIFY_URL
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachabletaigrr/gotify-mcp is public and reachablegithub.com/taigrr/gotify-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)0BSDspdx.org/licenses/0BSD.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-08github.com/taigrr/gotify-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubgotify-mcp
A Model Context Protocol (MCP) server that enables LLMs to send notifications to a Gotify server. This allows AI assistants to notify users about task completion, request help, or provide activity summaries.
Features
- Send Message: Send custom messages with configurable priority and title
- Ask for Help: Send help request notifications with context and error details
- Notify Completion: Send task completion notifications with results
- Summarize Activity: Send activity summaries with optional details
Environment Variables
The MCP server requires the following environment variables:
GOTIFY_URL: The URL of your Gotify server (e.g.,https://gotify.example.com)GOTIFY_TOKEN: Your Gotify application token for authentication
Installation
go install github.com/taigrr/gotify-mcp@latest
Or build from source:
git clone https://github.com/taigrr/gotify-mcp.git
cd gotify-mcp
go build -o gotify-mcp
Usage
The MCP server communicates over stdio and provides the following tools:
send-message
Send a custom message to Gotify.
Parameters:
message(required): The message content to sendtitle(optional): Title for the messagepriority(optional): Message priority (0-10, default: 5)contentType(optional): Message content type (text/plainortext/markdown)
ask-for-help
Send a help request notification.
Parameters:
context(required): Context or description of what help is needederror(optional): Optional error message or details
notify-completion
Send a task completion notification.
Parameters:
task(required): Description of the completed taskresult(optional): Optional result or outcome details
summarize-activity
Send an activity summary notification.
Parameters:
summary(required): Summary of activities or current statusdetails(optional): Optional additional details
Integration with MCP Clients
To use this MCP server with an MCP client, configure it to run the gotify-mcp binary with the appropriate environment variables set.
Example configuration for Claude Desktop:
{
"mcpServers": {
"gotify": {
"command": "/path/to/gotify-mcp",
"env": {
"GOTIFY_URL": "https://your-gotify-server.com",
"GOTIFY_TOKEN": "your-application-token"
}
}
}
}
License
This project is licensed under the 0BSD License, written by Rob Landley. As such, you may use this library without restriction or attribution, but please don't pass it off as your own. Attribution, though not required, is appreciated.
By contributing, you agree all code submitted also falls under the License.
Gotify MCP questions
What tools does the Gotify MCP server provide?
The server provides tools to send custom messages, request help with context, notify about task completion, and summarize activities.