Can I use Gotify as a CLI?

Yes. KosmoKrator exposes a Gotify CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Gotify through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Gotify tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Gotify credentials stored?

Gotify credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Gotify MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

messaging

Gotify CLI for Shell Scripts

Use the Gotify CLI for shell scripts with headless JSON commands, schema discovery, credentials, and permission controls.

5 functions 3 read 2 write API token auth

Submit Gotify feedback View package source

Gotify CLI for Shell Scripts

Call integration functions from shell scripts with stable JSON input and output.

Use shell scripts for small local automations that need one or more integration calls. The Gotify CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Gotify CLI for Shell Scripts
kosmokrator integrations:configure gotify --set app_token="$GOTIFY_APP_TOKEN" --set hostname="$GOTIFY_HOSTNAME" --enable --read allow --write ask --json
kosmo integrations:call gotify.gotify_list_messages '{"limit":1,"since":1}' --json

Discovery Before Execution

Agents and scripts can inspect Gotify docs and schemas before choosing a function.

kosmo integrations:docs gotify --json
kosmo integrations:docs gotify.gotify_list_messages --json
kosmo integrations:schema gotify.gotify_list_messages --json
kosmo integrations:search "Gotify" --json
kosmo integrations:list --json

Useful Gotify CLI Functions

Function	Type	Parameters	Description
`gotify.gotify_list_messages`	Read	limit, since	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	title, message, priority	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	id	Delete a message from Gotify by its ID. Use the list_messages tool to find message IDs.
`gotify.gotify_get_health`	Read	none	Check the health status of the Gotify server. Returns server health information including database status.
`gotify.gotify_get_current_user`	Read	none	Get information about the currently authenticated Gotify user, including username and admin status.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Gotify CLI Pages

CI Gotify CLI for CI. Cron Jobs Gotify CLI for cron jobs. Headless Automation Gotify CLI for headless automation. Coding Agents Gotify CLI for coding agents.