Getting Started
Download the App and Register
Download the app from the MeowPush website. Once you sign up or sign in and allow notifications, your device is ready to receive push notifications.
Copy a Push Key
Open the Guide page in the app and copy the Push Key for the intended target:
- This Device: The Push Key for the current device. Messages are sent only to this device.
- All Devices: The Push Key for all devices. Messages are sent to every device under the account.
You can also create a device group from Manage Keys to obtain a Push Key for a custom set of devices.
Keep Your Push Key Safe
A Push Key is the only credential required to send notifications. Never commit a real key to a public repository or share a screenshot containing one online.
Send Push Notifications with an Agent
To use MeowPush in an AI agent workflow, or to have an agent help you send notifications, tell it:
Please refer to https://usepush.md and help me configure push notifications.Send Push Notifications with the API
To send notifications yourself or integrate them into your own service, use the API. It is a minimal MeowPush HTTP API for sending notifications to devices or device groups.
The following curl example sends a notification. Replace <Your Push Key> with the Push Key copied from the app:
curl -X POST 'https://send.meowpush.com/' \
-H 'Content-Type: application/json' \
-d '{
"key": "<Your Push Key>",
"body": "Meow World!"
}'The Call the API page in the app also provides examples that you can copy and run.
When the API response contains status: "accepted", the upstream push service has accepted the request. Your device should receive the system notification shortly afterward.
For detailed information about the MeowPush API, see the API documentation.