Simplepush

Install

Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/simplepu-sh-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

9 read · 5 write · 0 delete

Secrets

3 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Node.js package

Tools (14)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• append_subtaskAppend a subtask to an earlier task

  Add a follow-up question or checklist item to a task sent with send_task. Pass the append_token from that result: a task's token appends to that one task; a group's token appends to every instance of the group (narrow with `instances`). Subtasks take the same content, `inputs` and `reply` as send_task and are answered on their own; read them with get_task (the chain) or get_group_status. Never waits.

• cancel_taskCancel a task, subtask or group

  Withdraw something sent earlier: pass a task_id (tsk_...), subtask_id (sub_...) or group_id (grptsk_...). Pending recipients see it as canceled and can no longer answer; answers already given stay. Canceling a group cancels every still-pending instance and reports how many were already finished. Not undoable.

• download_attachmentDownload a photo or file

  Fetches a photo, voice recording or file by the id of what holds it and the id of the file, the same pair the SDK's download takes. Images come back inline so you can look at them; other files come back as a short-lived download URL plus metadata. Needs the 'files:read' scope.

• get_activityEverything going on for a member (or the whole organization)

  Use this first for 'any problems with <member>?', 'what is going on with <member> / at the site?', 'catch me up', 'anything I should know?'. One call returns the bundle: open tasks, tasks that were declined or expired, and the window's answers, replies, declines, cancellations and ad-hoc submissions — with who and when. Defaults to the last 7 days. Omit member for the whole organization.

• get_group_statusStatus of a task group

  Answers 'who has answered and who has not' for a task sent to several people as independent copies (a grptsk_ group id, as shown on tasks from query_tasks): one summary per recipient plus a count per status.

• get_notification_answerGet the pick on an earlier notification

  Check whether a notification sent with send_notification and an `input` has been answered. Pass the notification_id it returned. Returns the pick, pending if untouched, or delivered when the notification carried no input (nothing to answer).

• get_taskRead one task with its subtasks

  Answers 'what exactly was asked and answered on this task'. The full content of one task and every subtask appended to it: who it was delivered to (recipients), the questions, the answers given, replies, declines, and the uploads (inputId) and reply files (id) for download_attachment. Use after query_tasks or get_activity has identified the task. A task sent to several people carries its grptsk_ groupId — follow it with get_group_status for the other recipients' copies.

• get_task_answerGet the answer to an earlier task

  Check whether a task sent with send_task, or a subtask added with append_subtask, has been answered. Pass exactly one of task_id or subtask_id. A task is answered by its inputs or, when it has none, by its reply thread: the first reply answers it. The result lists `answers` (input answers) and `replies` (the thread: author, time, text, files), or pending if nothing has come in yet. Each answer names its input's kind (text, choice, photo, voiceRecording, file, …) and carries the input's description. A task with inputs AND a thread stays pending until the inputs are done but still lists its repl…

• query_eventsRead the organization's activity history

  Answers 'what happened' — the place to look for anything reported, answered, replied, declined or cancelled, oldest first, each with who did it and when. This is where problems surface; query_tasks does not contain them. Defaults to the last 7 days. Filter by member or by event type (TaskCompleted, TaskInputCompleted, SubtaskCompleted, ReplyAppended, SubmissionCreated, TaskDeclinedByRecipient, TaskCanceled, TaskExpired, ...). For a ready-made bundle per member use get_activity; for ad-hoc reports alone use query_submissions.

• query_submissionsRead ad-hoc submissions from the field

  Answers 'did anyone report something on their own' — reports people sent without being asked (not answers to a task): text, photo, file, voice note, location, with who sent it and when. Check this whenever a question is about problems or reports; the task index never shows these. Oldest first; defaults to the last 7 days. Photos and files carry their id for download_attachment (scope_id = the sbm_ id).

• query_tasksList the organization's tasks

  Answers 'which tasks are open, expired, declined or done, and who has them'. Status only — it never shows what people answered or reported; for that use get_task, query_events or get_activity. One page of compact summaries, newest first: id, title, tag, topic, status, when it closed (closedAt, for completed, canceled, declined or expired), recipients, input kinds and reply mode (what sort of answer it expects), attachment kinds (file, link), sent time, and a per-status count of the task's subtasks (checklist items). Filter by status, time window, topic, member, or group.

• search_knowledgeSearch everything by words or by place

  Full-text and location search over everything this credential reads — the organization's records, or what a personal account sent and submitted: task titles and content, answers, replies, notifications and their answers, and ad-hoc submissions — across all time, ranked. Use it for 'anything about X?', 'what was said about X?', 'who mentioned X?'. Words match literally, and by stem in the languages the organization configured (so 'leak' finds 'leaking' only where stemming is on); several words must all appear; quote a phrase for adjacency. For 'what happened around <place>?' pass center/radius_…

• send_notificationSend a push notification

  Send a push notification to phones. A notification lives only in the banner: once dismissed it is gone, so it suits alerts and heads-ups, not questions that must be answered. It can still carry one `input` — a text input, a choice, or action buttons. By default the call returns right after sending and the answer is readable later with get_notification_answer; set wait_seconds to wait for it in the same call. Each recipient gets their own copy by default; with several recipients the result lists one notification_id per person. For a question that needs an answer, a photo, file, location, slider…

• send_taskSend a task (a question, form or checklist item that needs an answer)

  Description is built at runtime.

Signals

Stars

0

Forks

0

Open issues

0

Last commit

Sep 25, 2026 (1 month ago)

Last release

Sep 25, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

sh.simplepu/mcp

Version

0.4.0

Auth

Auth not stated, API key

Packages

npm @simplepush/mcp

License

License unknown

Repository

github.com/simplepush/simplepush-mcp

Website

simplepu.sh

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql