messaging
Gotify MCP, CLI, and Lua Integration for AI Agents
Gotify integration docs for AI agents: MCP gateway setup, Gotify CLI commands, Lua API reference, credentials, and function schemas.
5 functions 3 read 2 write API token auth
Gotify for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Machine-Readable Metadata
- integration_slug
gotify- route_slug
gotify- package
gotify- auth_strategy
api_tokenAPI token- cli_setup_supported
true- cli_runtime_supported
true- mcp_gateway_supported
true- lua_supported
true- supports_multi_account
true
Quick Links
Lua APIAgent-facing namespace and function reference. Gotify CLIHeadless setup and direct function calls. Gotify MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.
Gotify MCP Client Matrix
Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Gotify.
Claude Code Gotify MCP setup for Claude Code. Cursor Gotify MCP setup for Cursor. Codex Gotify MCP setup for Codex. OpenAI Agents Gotify MCP setup for OpenAI Agents SDK. Claude Agent SDK Gotify MCP setup for Claude Agent SDK. Vercel AI SDK Gotify MCP setup for Vercel AI SDK. LangChain Gotify MCP setup for LangChain. LangGraph Gotify MCP setup for LangGraph. CrewAI Gotify MCP setup for CrewAI. MCP clients Gotify MCP setup for Generic MCP Clients.
Gotify CLI Matrix
Use these pages for direct Gotify CLI workflows in scripts, CI, cron, and agent wrappers.
CI Gotify CLI for CI. Cron Jobs Gotify CLI for cron jobs. Shell Scripts Gotify CLI for shell scripts. Headless Automation Gotify CLI for headless automation. Coding Agents Gotify CLI for coding agents.
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
gotify.gotify_list_messages | Read read | 2 | List messages from the Gotify application. Returns the most recent messages, with optional pagination using "since" to fetch messages newer than a given ID. |
gotify.gotify_create_message | Write write | 3 | Send a notification message via Gotify. The message body supports Markdown formatting. Use priority 0–4 for low, 5 for normal, and 6–10 for high priority. |
gotify.gotify_delete_message | Write write | 1 | Delete a message from Gotify by its ID. Use the list_messages tool to find message IDs. |
gotify.gotify_get_health | Read read | 0 | Check the health status of the Gotify server. Returns server health information including database status. |
gotify.gotify_get_current_user | Read read | 0 | Get information about the currently authenticated Gotify user, including username and admin status. |