# Simplepush

Simplepush delivers interactive tasks and alerts from AI agents directly to user phones, collecting input and indexing every answer into a searchable log.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: simplepush
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/simplepush/simplepush-mcp
- Updated: 2026-09-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/simplepush

## What it does

The server equips an agent with tools to ping phones directly. Quick alerts run through `send_notification`, optionally carrying button choices or a single text prompt. For richer input, `send_task` delivers questionnaires that accept sliders, files, camera snapshots, voice recordings, or coordinates.

During `send_task`, the agent waits 90 seconds by default while checking for replies every 2000 ms. Reaching this limit does not revoke the prompt on the user device. The agent can proceed and inspect later replies via `get_task_answer`. Every submission, reply, and decline remains queryable: `search_knowledge` runs text queries with three-language stemming or filters records located within a coordinate radius.

Authentication uses either a personal `SP_API_TOKEN` or a team `SP_INTEGRATION_TOKEN`. If both exist in the environment, the integration credential takes priority. Reading historical queries on a personal account requires an active Simplepush subscription.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.simplepu.sh/mcp`
- Environment variables: `SP_API_TOKEN`, `SP_INTEGRATION_TOKEN`, `SP_KEYS`, `SP_BASE_URL`, `SP_MAX_WAIT_SECONDS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.simplepu.sh/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env SP_API_TOKEN=<SP_API_TOKEN> --env SP_INTEGRATION_TOKEN=<SP_INTEGRATION_TOKEN> --env SP_KEYS=<SP_KEYS> --env SP_BASE_URL=<SP_BASE_URL> --env SP_MAX_WAIT_SECONDS=<SP_MAX_WAIT_SECONDS> --transport stdio simplepush -- npx -y @simplepush/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add simplepush --url https://mcp.simplepu.sh/mcp
```

2. **Platform CLI**
```bash
codex mcp add simplepush --env SP_API_TOKEN=<SP_API_TOKEN> --env SP_INTEGRATION_TOKEN=<SP_INTEGRATION_TOKEN> --env SP_KEYS=<SP_KEYS> --env SP_BASE_URL=<SP_BASE_URL> --env SP_MAX_WAIT_SECONDS=<SP_MAX_WAIT_SECONDS> -- npx -y @simplepush/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "simplepush": {
            "url": "https://mcp.simplepu.sh/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "simplepush": {
            "command": "npx",
            "args": [
                "-y",
                "@simplepush/mcp"
            ],
            "env": {
                "SP_API_TOKEN": "<SP_API_TOKEN>",
                "SP_INTEGRATION_TOKEN": "<SP_INTEGRATION_TOKEN>",
                "SP_KEYS": "<SP_KEYS>",
                "SP_BASE_URL": "<SP_BASE_URL>",
                "SP_MAX_WAIT_SECONDS": "<SP_MAX_WAIT_SECONDS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "simplepush": {
            "type": "http",
            "url": "https://mcp.simplepu.sh/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "simplepush": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@simplepush/mcp"
            ],
            "env": {
                "SP_API_TOKEN": "<SP_API_TOKEN>",
                "SP_INTEGRATION_TOKEN": "<SP_INTEGRATION_TOKEN>",
                "SP_KEYS": "<SP_KEYS>",
                "SP_BASE_URL": "<SP_BASE_URL>",
                "SP_MAX_WAIT_SECONDS": "<SP_MAX_WAIT_SECONDS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http simplepush https://mcp.simplepu.sh/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e SP_API_TOKEN=<SP_API_TOKEN> -e SP_INTEGRATION_TOKEN=<SP_INTEGRATION_TOKEN> -e SP_KEYS=<SP_KEYS> -e SP_BASE_URL=<SP_BASE_URL> -e SP_MAX_WAIT_SECONDS=<SP_MAX_WAIT_SECONDS> simplepush npx -y @simplepush/mcp
```
Replace <…> with your own values

## When to use it
- dispatch approval buttons to a phone during pipeline runs
- collect field photos, audio notes, or coordinates from mobile users
- query past team responses using keywords or boundary coordinates
- assign a shared prompt to a topic where the fastest response resolves it

## Example prompts
- Send a confirmation task to my phone with yes/no action buttons and wait for my response.
- Search past submissions within a two-kilometer radius using `search_knowledge`.
- Check the current delivery progress for task group `grptsk_123` with `get_group_status`.

## Similar
- [capacitor-push-notifications](https://affpapa.org/en/nevibecode/skills/capawesome-team-capacitor-push-notifications.md) — skill · 1600 installs
- [retention-optimization](https://affpapa.org/en/nevibecode/skills/retention-optimization.md) — skill · 3600 installs
- [push-notifications](https://affpapa.org/en/nevibecode/skills/push-notifications.md) — skill · 4500 installs
- [push-notification-setup](https://affpapa.org/en/nevibecode/skills/secondsky-push-notification-setup.md) — skill · 444 installs
- [human-gate](https://affpapa.org/en/nevibecode/skills/human-gate.md) — skill · 8 installs
- [ae-engage](https://affpapa.org/en/nevibecode/skills/ae-engage.md) — skill · 1000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
