Simplepush — Claude Code MCP server: what it does, how to install
Simplepush delivers interactive tasks and alerts from AI agents directly to user phones, collecting input and indexing every answer into a searchable log.
no license updated 2026-09-25
claude mcp add --transport http mcp https://mcp.simplepu.sh/mcpWhat Simplepush 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.
What it helps with
- 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 for the agent
- 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_123withget_group_status.
How to install Simplepush
1Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.simplepu.sh/mcp2Platform CLI
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/mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add simplepush --url https://mcp.simplepu.sh/mcp2Platform CLI
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/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"simplepush": {
"url": "https://mcp.simplepu.sh/mcp"
}
}
}{
"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
Config file
{
"servers": {
"simplepush": {
"type": "http",
"url": "https://mcp.simplepu.sh/mcp"
}
}
}{
"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
1Platform CLI: remote server
gemini mcp add -t http simplepush https://mcp.simplepu.sh/mcp2Platform CLI
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/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Simplepush
How do I install Simplepush in Claude Code?
For HTTP transport, run claude mcp add --transport http simplepush https://mcp.simplepu.sh/mcp. To run via stdio instead, execute `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`.
What does the Simplepush MCP server do?
It lets an AI assistant push alerts and multi-input task forms to mobile phones. Agents can wait for user replies in real time and search through historical answers, files, and location data.
What happens if send_task hits its timeout?
A timeout does not cancel the prompt on the recipient device. The agent unblocks, and the response can be retrieved later with get_task_answer once the user submits it.