# palmpush

> palmpush lets scripts, automations, backend jobs, and AI agents send messages to listeners on your iPhone.

Both files are generated from the same documentation source. The topic links below are the canonical website guides.

## Documentation in Markdown

- [Complete documentation](https://www.palmpush.com/llms-full.txt): All guides and code examples in one file.

## The app

- [Getting started](https://www.palmpush.com/docs): Create a listener, send your first message, and find it in palmpush History.
- [Listeners and History](https://www.palmpush.com/docs/concepts): Manage palmpush listeners, per-device avatars, notification settings, and event History.

## Sending

- [HTTP API](https://www.palmpush.com/docs/send): Send messages, image attachments, and links with the palmpush HTTP API. Check fields, limits, and delivery responses.
- [Images](https://www.palmpush.com/docs/images): Attach an image to a palmpush notification using an HTTPS image URL, and view it in History.
- [Links and tap actions](https://www.palmpush.com/docs/links): Open a website, a supported app, or the matching palmpush History entry when a notification is tapped.

## Integrations

- [JavaScript](https://www.palmpush.com/docs/javascript): Send palmpush messages from JavaScript, handle failures, and target one or more listeners.
- [AI agents (MCP)](https://www.palmpush.com/docs/mcp): Let local AI agents send palmpush notifications through MCP.
- [PWA setup](https://www.palmpush.com/docs/pwa): Register a Progressive Web App as a palmpush notification target.

## Help

- [Troubleshooting](https://www.palmpush.com/docs/troubleshooting): Check failed requests, missing alerts, image attachments, payload limits, and notification tap behavior.