# Gotify MCP for AI Agents AI Agent Connect

> Gotify lets you manage push notifications through your AI agent. You can send alerts, list messages, and handle app tokens for your self-hosted notification hub. It connects your personal notification hub to your agent so you can stay updated on system events or home automation triggers without switching tabs. This Connector gives you a direct way to interact with your private notification infrastructure using natural language.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_jCMBoY8bV2ZP1KOUCZXpiqOL2iZLW12SkBuGMVQX/ai-agent-connect
- **Tags:** push-notifications, self-hosted, alerts, messaging-api, server-management

## Description

This Connector lets your AI agent act as the middleman, allowing you to talk to your notification hub in plain English. Instead of hunting through a dashboard to check if a build finished or a sensor tripped, you can just ask your agent to show you the latest alerts or send a high-priority ping to your phone. It handles the heavy lifting of managing application tokens and client authorizations so you don't have to mess with headers or complex API calls. You can organize your notification sources by creating specific applications for different projects, like your CI/CD pipeline or your smart home setup. When you find it in the Vinkius catalog, you're getting a way to connect your private infrastructure and your AI's capabilities. It works by letting the agent handle the messy details of user administration and message deletion, giving you a clean way to keep your notifications organized and actionable. You can set up custom priorities, manage multiple clients across different devices, and even check the health of your instance to make sure everything is running smoothly. Whether you're monitoring a production environment or just want to know when your laundry is done, this connection makes your notifications part of a cohesive system rather than a scattered mess of pings.

## Tools

### change_password
Update the password for the current user account. Use this to keep your hub access secure.

### delete_all_messages
Wipe the entire message history for your current client. Use this to clear out old alerts quickly.

### delete_application
Remove an application from your notification hub. This cleans up your active notification sources.

### delete_client
Delete a client to revoke device access. Use this to remove old or lost devices from your hub.

### delete_message
Remove a specific message from your stream. This helps you keep your recent history tidy.

### get_applications
List all current applications and their details. Use this to see how your notification sources are organized.

### get_clients
List all authorized clients on your hub. This shows which devices are currently connected.

### get_current_user
See details about the user currently logged into the Connector. This confirms your current session status.

### get_health
Check if your Gotify instance is running correctly. This is a quick way to verify your hub is online.

### get_messages
Retrieve the list of messages for your authenticated client. Use this to see your latest pings.

### get_plugin_config
View the configuration settings for your active plugins. This helps you manage your hub's extra features.

### update_client
Update the details of a specific client. Use this to change device permissions or names.

### update_plugin_config
Change the settings for your notification plugins. This lets you tweak your hub's extra behavior.

### create_application
Create a new application to organize notification sources. This helps you group alerts by project.

### create_client
Create a new client to authorize a specific device. Use this to add new phones or tablets to your hub.

### create_user
Create a new user account on your Gotify instance. This is for admin-level access management.

### get_plugin_display
See how your plugins are displayed in the interface. Use this to check your hub's UI configuration.

### get_plugins
List all plugins currently installed on your instance. This shows what extra features your hub has.

### get_users
List all users on your instance. This is an admin-only tool for managing hub access.

### get_version
Check the current version of your Gotify instance. Use this to see if you need to update your hub.

### send_message
Send a push notification with a title and priority level. This is the main tool for getting alerts.

### update_application
Modify the settings of an existing application. Use this to change how your alerts are organized.

## Prompt Examples

**Prompt:** 
```
Send a high-priority Gotify message titled 'Server Down' saying 'Database connection failed on Node 3'.
```

**Response:** 
```
I've sent the high-priority message (Priority 8) to your Gotify hub. The message **'Database connection failed on Node 3'** has been pushed successfully.

**Status Summary:**
- **Title:** Server Down
- **Priority:** 8
- **Status:** Sent
```

**Prompt:** 
```
List my current Gotify applications.
```

**Response:** 
```
I found 3 active applications on your hub:

| Application | Description |
| :--- | :--- |
| **Backup-Bot** | Status alerts |
| **GitHub-Webhooks** | Repo updates |
| **Home-Monitor** | IoT sensors |

Which one would you like to manage?
```

**Prompt:** 
```
Get the last 5 messages from my Gotify hub.
```

**Response:** 
```
Retrieving your recent messages...

I've found 5 messages. The most recent is **'Build Success'** from 10 minutes ago. Would you like me to summarize the others?
```

## Capabilities

### Send push notifications
Send alerts with specific titles and priorities to your hub.

### List recent messages
See what's happened on your hub lately in a single view.

### Manage app tokens
Create or update applications for different sources.

### Control client devices
Authorize specific devices to receive pings.

### Handle user access
Manage who can see what on your instance.

### Delete old alerts
Clear out your message history quickly.

### Check hub status
Verify your notification hub is actually online.

## Use Cases

### CI/CD Pipeline Alerts
A DevOps engineer asks their agent to send a high-priority Gotify message when a production build fails, including the specific error code.

### Smart Home Sensor Monitoring
A home automation fan asks their agent to check the last 5 messages to see if any door sensors were triggered in the last hour.

### App Token Management
A developer needs to rotate their notification keys and uses the agent to `update_application` without opening the web console.

### Bulk Message Cleanup
A user wants to clear their notification history after a maintenance window and asks the agent to `delete_all_messages`.

## Benefits

- Send high-priority alerts using `send_message` to get instant updates on critical system failures.
- Manage your entire notification ecosystem without leaving your chat by using `get_applications`.
- Keep your message history clean by quickly clearing alerts with `delete_all_messages`.
- Secure your private hub by managing access through `create_user` and `create_client`.
- Verify your infrastructure is live at any time using `get_health` to ensure your alerts are flowing.
- Organize multiple projects easily by creating unique applications for each via `create_application`.

## How It Works

The bottom line is you get a voice-controlled way to manage and send push notifications from your own private hub.

1. Subscribe to the Gotify MCP on Vinkius.
2. Enter your Gotify URL along with your Application and Client tokens.
3. Ask your AI client to send alerts or manage your notification settings.

## Frequently Asked Questions

**What is Gotify MCP?**
It's a way to connect your self-hosted notification hub to your AI agent. It lets you send and manage alerts using natural language.

**Can I send push notifications with Gotify MCP?**
Yes, you can send alerts with custom titles and priority levels directly through your AI client.

**Is Gotify MCP for private servers?**
Yes, it is specifically designed for people who want to manage their own private notification hub instead of using a cloud service.

**How do I manage my apps with Gotify MCP?**
You can ask your agent to list, create, or update your notification applications. It handles all the configuration for you.

**Can Gotify MCP delete old alerts?**
Yes, you can ask your agent to clear out your message history or delete specific messages to keep your hub tidy.

**Does Gotify MCP support multiple devices?**
Yes, you can manage and authorize different clients, allowing multiple devices to receive your notifications.

**How do I send a notification to my phone using this server?**
Use the `send_message` tool. You'll need to provide a message and a title. Ensure you have configured your `GOTIFY_APP_TOKEN` so the server knows which application is sending the alert.

**Can I clear all messages from my Gotify stream at once?**
Yes, you can use the `delete_all_messages` tool. This requires a valid `GOTIFY_CLIENT_TOKEN` to authorize the deletion of messages for that specific client.

**Is it possible to create new application tokens via AI?**
Absolutely. Use the `create_application` tool with a name and optional description. The AI will return the details of the new application, including its token.