Can I use Pushover as a CLI?

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

Can I expose Pushover through MCP?

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

Where are Pushover credentials stored?

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

Can I deny write access for Pushover MCP tools?

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

productivity

Pushover CLI for AI Agents

Use the Pushover CLI from KosmoKrator to call Pushover tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

Pushover CLI Setup

Pushover can be configured headlessly with `kosmokrator integrations:configure pushover`.

Install, configure, and verify

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure pushover --set api_key="$PUSHOVER_API_KEY" --set user_key="$PUSHOVER_USER_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor pushover --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

Key	Env var	Type	Required	Label
`api_key`	`PUSHOVER_API_KEY`	Secret `secret`	yes	Application API Key
`user_key`	`PUSHOVER_USER_KEY`	Secret `secret`	yes	User Key
`url`	`PUSHOVER_URL`	URL `url`	no	API Base URL
`team_token`	`PUSHOVER_TEAM_TOKEN`	Secret `secret`	no	Team API Token

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call pushover.pushover_add_group_user '{"group_key":"example_group_key","user_key":"example_user_key","device":"example_device","memo":"example_memo"}' --json

Provider shortcut

kosmo integrations:pushover pushover_add_group_user '{"group_key":"example_group_key","user_key":"example_user_key","device":"example_device","memo":"example_memo"}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands

kosmo integrations:docs pushover --json
kosmo integrations:docs pushover.pushover_add_group_user --json
kosmo integrations:schema pushover.pushover_add_group_user --json
kosmo integrations:search "Pushover" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`pushover.pushover_add_group_user`

Add a user key, optionally scoped to a device, to a Pushover delivery group.

Write write

Parameters: group_key, user_key, device, memo

Generic call

kosmo integrations:call pushover.pushover_add_group_user '{"group_key":"example_group_key","user_key":"example_user_key","device":"example_device","memo":"example_memo"}' --json

Shortcut

kosmo integrations:pushover pushover_add_group_user '{"group_key":"example_group_key","user_key":"example_user_key","device":"example_device","memo":"example_memo"}' --json

`pushover.pushover_add_team_user`

Add a user to a Pushover team. Requires the optional team_token credential.

Write write

Parameters: email, name, password, instant, admin, group

Generic call

kosmo integrations:call pushover.pushover_add_team_user '{"email":"example_email","name":"example_name","password":"example_password","instant":true,"admin":true,"group":"example_group"}' --json

Shortcut

kosmo integrations:pushover pushover_add_team_user '{"email":"example_email","name":"example_name","password":"example_password","instant":true,"admin":true,"group":"example_group"}' --json

`pushover.pushover_assign_license`

Assign a prepaid Pushover license credit to an existing user key or invite an email address for a specific platform.

Write write

Parameters: user_key, email, os

Generic call

kosmo integrations:call pushover.pushover_assign_license '{"user_key":"example_user_key","email":"example_email","os":"example_os"}' --json

Shortcut

kosmo integrations:pushover pushover_assign_license '{"user_key":"example_user_key","email":"example_email","os":"example_os"}' --json

`pushover.pushover_cancel_receipt`

Cancel retry notifications for an active emergency-priority message receipt.

Write write

Parameters: receipt

Generic call

kosmo integrations:call pushover.pushover_cancel_receipt '{"receipt":"example_receipt"}' --json

Shortcut

kosmo integrations:pushover pushover_cancel_receipt '{"receipt":"example_receipt"}' --json

`pushover.pushover_cancel_receipts_by_tag`

Cancel retry notifications for active emergency-priority messages that were sent with a matching tag.

Write write

Parameters: tag

Generic call

kosmo integrations:call pushover.pushover_cancel_receipts_by_tag '{"tag":"example_tag"}' --json

Shortcut

kosmo integrations:pushover pushover_cancel_receipts_by_tag '{"tag":"example_tag"}' --json

`pushover.pushover_create_group`

Create a Pushover delivery group and return its group key.

Write write

Parameters: name

Generic call

kosmo integrations:call pushover.pushover_create_group '{"name":"example_name"}' --json

Shortcut

kosmo integrations:pushover pushover_create_group '{"name":"example_name"}' --json

`pushover.pushover_disable_group_user`

Temporarily disable a user key, optionally scoped to a device, in a Pushover delivery group.

Write write

Parameters: group_key, user_key, device

Generic call

kosmo integrations:call pushover.pushover_disable_group_user '{"group_key":"example_group_key","user_key":"example_user_key","device":"example_device"}' --json

Shortcut

kosmo integrations:pushover pushover_disable_group_user '{"group_key":"example_group_key","user_key":"example_user_key","device":"example_device"}' --json

`pushover.pushover_enable_group_user`

Re-enable a disabled user key, optionally scoped to a device, in a Pushover delivery group.

Write write

Parameters: group_key, user_key, device

Generic call

kosmo integrations:call pushover.pushover_enable_group_user '{"group_key":"example_group_key","user_key":"example_user_key","device":"example_device"}' --json

Shortcut

kosmo integrations:pushover pushover_enable_group_user '{"group_key":"example_group_key","user_key":"example_user_key","device":"example_device"}' --json

`pushover.pushover_get_application_limits`

Get the monthly message limit, remaining messages, reset timestamp, and application status for the Pushover app token.

Read read

Parameters: none

Generic call

kosmo integrations:call pushover.pushover_get_application_limits '{}' --json

Shortcut

kosmo integrations:pushover pushover_get_application_limits '{}' --json

`pushover.pushover_get_current_user`

Validate the configured Pushover user or group key and return active devices and licenses.

Read read

Parameters: none

Generic call

kosmo integrations:call pushover.pushover_get_current_user '{}' --json

Shortcut

kosmo integrations:pushover pushover_get_current_user '{}' --json

`pushover.pushover_get_group`

Get a Pushover delivery group name and member list by group key.

Read read

Parameters: group_key

Generic call

kosmo integrations:call pushover.pushover_get_group '{"group_key":"example_group_key"}' --json

Shortcut

kosmo integrations:pushover pushover_get_group '{"group_key":"example_group_key"}' --json

`pushover.pushover_get_license_credits`

Get the number of prepaid Pushover license credits available for assignment.

Read read

Parameters: none

Generic call

kosmo integrations:call pushover.pushover_get_license_credits '{}' --json

Shortcut

kosmo integrations:pushover pushover_get_license_credits '{}' --json

`pushover.pushover_get_receipt`

Get acknowledgement state, callback data, and retry status for an emergency-priority message receipt.

Read read

Parameters: receipt

Generic call

kosmo integrations:call pushover.pushover_get_receipt '{"receipt":"example_receipt"}' --json

Shortcut

kosmo integrations:pushover pushover_get_receipt '{"receipt":"example_receipt"}' --json

`pushover.pushover_get_team`

Show Pushover team information and users. Requires the optional team_token credential.

Read read

Parameters: none

Generic call

kosmo integrations:call pushover.pushover_get_team '{}' --json

Shortcut

kosmo integrations:pushover pushover_get_team '{}' --json

`pushover.pushover_list_groups`

List Pushover delivery groups that the application token can manage.

Read read

Parameters: none

Generic call

kosmo integrations:call pushover.pushover_list_groups '{}' --json

Shortcut

kosmo integrations:pushover pushover_list_groups '{}' --json

`pushover.pushover_list_sounds`

List available notification sounds in Pushover. Use sound names with the send_message tool.

Read read

Parameters: none

Generic call

kosmo integrations:call pushover.pushover_list_sounds '{}' --json

Shortcut

kosmo integrations:pushover pushover_list_sounds '{}' --json

`pushover.pushover_migrate_subscription_user`

Create a Pushover subscription for an existing user key and return the subscription-scoped user key.

Read read

Parameters: subscription, user_key, device_name, sound

Generic call

kosmo integrations:call pushover.pushover_migrate_subscription_user '{"subscription":"example_subscription","user_key":"example_user_key","device_name":"example_device_name","sound":"example_sound"}' --json

Shortcut

kosmo integrations:pushover pushover_migrate_subscription_user '{"subscription":"example_subscription","user_key":"example_user_key","device_name":"example_device_name","sound":"example_sound"}' --json

`pushover.pushover_remove_group_user`

Remove a user key, optionally scoped to a device, from a Pushover delivery group.

Write write

Parameters: group_key, user_key, device

Generic call

kosmo integrations:call pushover.pushover_remove_group_user '{"group_key":"example_group_key","user_key":"example_user_key","device":"example_device"}' --json

Shortcut

kosmo integrations:pushover pushover_remove_group_user '{"group_key":"example_group_key","user_key":"example_user_key","device":"example_device"}' --json

`pushover.pushover_remove_team_user`

Remove a user from a Pushover team by email address. Requires the optional team_token credential.

Write write

Parameters: email

Generic call

kosmo integrations:call pushover.pushover_remove_team_user '{"email":"example_email"}' --json

Shortcut

kosmo integrations:pushover pushover_remove_team_user '{"email":"example_email"}' --json

`pushover.pushover_rename_group`

Rename a Pushover delivery group by group key.

Read read

Parameters: group_key, name

Generic call

kosmo integrations:call pushover.pushover_rename_group '{"group_key":"example_group_key","name":"example_name"}' --json

Shortcut

kosmo integrations:pushover pushover_rename_group '{"group_key":"example_group_key","name":"example_name"}' --json

`pushover.pushover_send_message`

Send a push notification via Pushover. Supports message, title, priority levels, and optional URL/sound attachments.

Write write

Parameters: message, title, priority, url, url_title, sound, device, timestamp, expire, retry, callback, tags, ttl, html, monospace, attachment_base64, attachment_type, encrypted

Generic call

kosmo integrations:call pushover.pushover_send_message '{"message":"example_message","title":"example_title","priority":1,"url":"example_url","url_title":"example_url_title","sound":"example_sound","device":"example_device","timestamp":1}' --json

Shortcut

kosmo integrations:pushover pushover_send_message '{"message":"example_message","title":"example_title","priority":1,"url":"example_url","url_title":"example_url_title","sound":"example_sound","device":"example_device","timestamp":1}' --json

`pushover.pushover_update_glance`

Update Pushover glance data shown in the Pushover widget and wearables: title, text, subtext, count, and percent.

Write write

Parameters: device, title, text, subtext, count, percent

Generic call

kosmo integrations:call pushover.pushover_update_glance '{"device":"example_device","title":"example_title","text":"example_text","subtext":"example_subtext","count":1,"percent":1}' --json

Shortcut

kosmo integrations:pushover pushover_update_glance '{"device":"example_device","title":"example_title","text":"example_text","subtext":"example_subtext","count":1,"percent":1}' --json

`pushover.pushover_validate_user`

Validate a Pushover user/group key and optional device before sending a message.

Read read

Parameters: user_key, device

Generic call

kosmo integrations:call pushover.pushover_validate_user '{"user_key":"example_user_key","device":"example_device"}' --json

Shortcut

kosmo integrations:pushover pushover_validate_user '{"user_key":"example_user_key","device":"example_device"}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

pushover.pushover_add_group_user 4 parameters

Schema command

kosmo integrations:schema pushover.pushover_add_group_user --json

Parameter	Type	Required	Description
`group_key`	string	yes	Pushover delivery group key.
`user_key`	string	yes	Pushover user key to add.
`device`	string	no	Optional device name for this group member.
`memo`	string	no	Optional memo to store with the member.

pushover.pushover_add_team_user 6 parameters

Schema command

kosmo integrations:schema pushover.pushover_add_team_user --json

Parameter	Type	Required	Description
`email`	string	yes	Email address for the team user.
`name`	string	no	Optional full name.
`password`	string	no	Optional initial password. If omitted, Pushover assigns and emails a random password.
`instant`	boolean	no	Include an Instant Login link in the welcome email.
`admin`	boolean	no	Add the user as a team administrator.
`group`	string	no	Optional team delivery group name to add the user to.

pushover.pushover_assign_license 3 parameters

Schema command

kosmo integrations:schema pushover.pushover_assign_license --json

Parameter	Type	Required	Description
`user_key`	string	no	Existing Pushover user key to license. Required unless email is provided.
`email`	string	no	Email address to invite and license. Required unless user_key is provided.
`os`	string	no	Platform for the license, e.g. iOS, Android, or Desktop.

pushover.pushover_cancel_receipt 1 parameters

Schema command

kosmo integrations:schema pushover.pushover_cancel_receipt --json

Parameter	Type	Required	Description
`receipt`	string	yes	Receipt ID returned when sending an emergency-priority message.

pushover.pushover_cancel_receipts_by_tag 1 parameters

Schema command

kosmo integrations:schema pushover.pushover_cancel_receipts_by_tag --json

Parameter	Type	Required	Description
`tag`	string	yes	Emergency message tag to cancel.

pushover.pushover_create_group 1 parameters

Schema command

kosmo integrations:schema pushover.pushover_create_group --json

Parameter	Type	Required	Description
`name`	string	yes	Human-readable group name.

pushover.pushover_disable_group_user 3 parameters

Schema command

kosmo integrations:schema pushover.pushover_disable_group_user --json

Parameter	Type	Required	Description
`group_key`	string	yes	Pushover delivery group key.
`user_key`	string	yes	Pushover user key to disable.
`device`	string	no	Optional device name to match.

pushover.pushover_enable_group_user 3 parameters

Schema command

kosmo integrations:schema pushover.pushover_enable_group_user --json

Parameter	Type	Required	Description
`group_key`	string	yes	Pushover delivery group key.
`user_key`	string	yes	Pushover user key to enable.
`device`	string	no	Optional device name to match.

pushover.pushover_get_application_limits 0 parameters

Schema command

kosmo integrations:schema pushover.pushover_get_application_limits --json

Parameter	Type	Required	Description
No parameters.

pushover.pushover_get_current_user 0 parameters

Schema command

kosmo integrations:schema pushover.pushover_get_current_user --json

Parameter	Type	Required	Description
No parameters.

pushover.pushover_get_group 1 parameters

Schema command

kosmo integrations:schema pushover.pushover_get_group --json

Parameter	Type	Required	Description
`group_key`	string	yes	Pushover delivery group key.

pushover.pushover_get_license_credits 0 parameters

Schema command

kosmo integrations:schema pushover.pushover_get_license_credits --json

Parameter	Type	Required	Description
No parameters.

pushover.pushover_get_receipt 1 parameters

Schema command

kosmo integrations:schema pushover.pushover_get_receipt --json

Parameter	Type	Required	Description
`receipt`	string	yes	Receipt ID returned when sending an emergency-priority message.

pushover.pushover_get_team 0 parameters

Schema command

kosmo integrations:schema pushover.pushover_get_team --json

Parameter	Type	Required	Description
No parameters.

pushover.pushover_list_groups 0 parameters

Schema command

kosmo integrations:schema pushover.pushover_list_groups --json

Parameter	Type	Required	Description
No parameters.

pushover.pushover_list_sounds 0 parameters

Schema command

kosmo integrations:schema pushover.pushover_list_sounds --json

Parameter	Type	Required	Description
No parameters.

pushover.pushover_migrate_subscription_user 4 parameters

Schema command

kosmo integrations:schema pushover.pushover_migrate_subscription_user --json

Parameter	Type	Required	Description
`subscription`	string	yes	Pushover subscription code.
`user_key`	string	yes	Existing Pushover user key to migrate.
`device_name`	string	no	Optional device name to limit the subscription to.
`sound`	string	no	Optional default notification sound for this subscribed user.

pushover.pushover_remove_group_user 3 parameters

Schema command

kosmo integrations:schema pushover.pushover_remove_group_user --json

Parameter	Type	Required	Description
`group_key`	string	yes	Pushover delivery group key.
`user_key`	string	yes	Pushover user key to remove.
`device`	string	no	Optional device name to match.

pushover.pushover_remove_team_user 1 parameters

Schema command

kosmo integrations:schema pushover.pushover_remove_team_user --json

Parameter	Type	Required	Description
`email`	string	yes	Email address of the team user to remove.

pushover.pushover_rename_group 2 parameters

Schema command

kosmo integrations:schema pushover.pushover_rename_group --json

Parameter	Type	Required	Description
`group_key`	string	yes	Pushover delivery group key.
`name`	string	yes	New group name.

pushover.pushover_send_message 18 parameters

Schema command

kosmo integrations:schema pushover.pushover_send_message --json

Parameter	Type	Required	Description
`message`	string	yes	The notification message body.
`title`	string	no	Optional title for the notification.
`priority`	integer	no	Message priority: -2 = no notification/alert, -1 = quiet notification, 0 = normal (default), 1 = high priority, 2 = emergency.
`url`	string	no	A supplementary URL to include with the notification.
`url_title`	string	no	Title for the supplementary URL.
`sound`	string	no	Notification sound name (e.g., "pushover", "bike", "echo"). Use the list_sounds tool to see available options.
`device`	string	no	Specific device name to send to. Omit to send to all devices.
`timestamp`	integer	no	Unix timestamp to schedule the message delivery.
`expire`	integer	no	Seconds until emergency-priority (2) messages expire (max 10800).
`retry`	integer	no	Seconds between retries for emergency-priority (2) messages (min 30).
`callback`	string	no	Callback URL for emergency-priority receipt acknowledgement updates.
`tags`	string	no	Comma-separated emergency message tags for later cancel-by-tag operations.
`ttl`	integer	no	Seconds after which an unacknowledged message should be discarded.
`html`	boolean	no	Enable HTML subset formatting in the message body.
`monospace`	boolean	no	Render the message body in monospace formatting.
`attachment_base64`	string	no	Base64-encoded attachment content.
`attachment_type`	string	no	MIME type for attachment_base64, e.g. image/jpeg.
`encrypted`	boolean	no	Marks the message as already Pushover-encrypted by the caller.

pushover.pushover_update_glance 6 parameters

Schema command

kosmo integrations:schema pushover.pushover_update_glance --json

Parameter	Type	Required	Description
`device`	string	no	Optional target device name.
`title`	string	no	Short glance title.
`text`	string	no	Primary glance text.
`subtext`	string	no	Secondary glance text.
`count`	integer	no	Integer count shown by the glance.
`percent`	integer	no	Percent value from 0 to 100.

pushover.pushover_validate_user 2 parameters

Schema command

kosmo integrations:schema pushover.pushover_validate_user --json

Parameter	Type	Required	Description
`user_key`	string	no	User or group key to validate. Defaults to the configured user key.
`device`	string	no	Optional device name to validate for the user.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.