NextMsg MCP server
Commit Nov 14, 2026Allows AI agents and autonomous scripts to send push notifications to your phone when tasks finish, fail, or require attention.
Also known as nextmsg-app/mcp
- Stars
- 0
- Tools
- 1
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 14, 2026
- License
- MIT
What is NextMsg MCP?
NextMsg allows AI agents and autonomous scripts to send push notifications to your phone when tasks finish, fail, or require attention. It exposes 1 tool, such as macOS.
Summary generated from the project's README
About NextMsg MCP server
Sending push notifications to your phone when autonomous tasks finish or fail is what this MCP server enables for developers. It acts as a one-way inbox for AI agents, long-running workflows, and scripts to communicate status updates directly to a mobile device. By integrating this server, you can receive alerts for completed model training, failed tests, or situations requiring human intervention without constantly checking your terminal.
Users can set up the server locally using Claude Desktop, Cursor, or via the command line with npx. Integration requires a NEXTMSG_KEY environment variable to authenticate with the NextMsg service. The server provides a specific notify_human tool that allows agents to send markdown-formatted messages between 1 and 640 characters. You can also organize alerts into specific categories using the channel parameter, such as ci, deploy, or ml, to keep your notifications structured.
What you can do with it
- 1Alerting on task completionAsk your AI agent to send a notification to your phone once it finishes a complex coding task.
- 2Tracking long-running machine learning jobsHave an autonomous script notify you when a model training process reaches a specific loss threshold.
- 3Automating Claude Code updatesSet up a hook so that Claude Code automatically sends a message to your phone after every turn.
Written from the project's README. Every use case is checked against a quote from it.
NextMsg MCP tools 1
Detected from the READMEmacOS
| macOS | — |
Configuration
NEXTMSG_KEY
| Name | Description | |
|---|---|---|
| NEXTMSG_KEY | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablenextmsg-app/mcp is public and reachablegithub.com/nextmsg-app/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-17github.com/nextmsg-app/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model1 tool description and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@nextmsg/mcp
Official Model Context Protocol (MCP) server and CLI notifier for NextMsg.
- npm: npmjs.com/package/@nextmsg/mcp, run it with
npx -y @nextmsg/mcp - Source: github.com/nextmsg-app/mcp
- Guides: nextmsg.app/guides (Claude Code, Cursor, Codex, Antigravity, GitHub Actions, AWS and more)
NextMsg is a one-way push notification inbox for developers. AI agents, autonomous scripts, and long-running workflows use it to notify your phone when tasks finish, fail, or need attention.
Quickstart: Use with AI Tools
1. Claude Desktop
Add to your claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"nextmsg": {
"command": "npx",
"args": ["-y", "@nextmsg/mcp"],
"env": {
"NEXTMSG_KEY": "nextmsg_live_YOUR_KEY_HERE"
}
}
}
}
2. Cursor
Go to Settings → Features → MCP Servers → Add New MCP Server:
- Name:
nextmsg - Type:
command - Command:
npx -y @nextmsg/mcp - Set environment variable
NEXTMSG_KEYto your send key.
3. Claude Code Hook
You can also set up a hook in ~/.claude/settings.json so Claude Code pings your phone whenever it finishes a turn. Set NEXTMSG_KEY in your shell profile (or in the env block of settings.json):
{
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "npx -y @nextmsg/mcp 'Claude Code finished task' --channel claude-code"
}
]
}
]
}
}
4. Direct CLI Usage
Send messages directly from your terminal or CI pipelines:
# Set your key once
export NEXTMSG_KEY="nextmsg_live_..."
# Send alert
npx @nextmsg/mcp "Model training complete: loss 0.12" --channel ml
# A message that starts with "-"
npx @nextmsg/mcp -- "-1 tests failing"
--key works too, but prefer NEXTMSG_KEY: a key on the command line ends up in shell history. If a key leaks, rotate it in the app (Settings).
MCP Tools Provided
notify_human
Sends a push notification to your phone. The agent uses it when a task finishes, fails or needs your input, and whenever you ask to be notified. Its description tells the agent to:
- send one notification per outcome, not progress updates
- answer in the conversation instead when you're actively chatting
- never include secrets, tokens or personal data (the text shows on the lock screen)
- report a failed send in the conversation instead of retrying
Parameters:
message(string, required): Alert text (1–640 characters). Supports markdown (**bold**,*italic*,~~strike~~,`code`). Links are inert text.channel(string, optional, default: "general"): Channel category tag (1–32 lowercase charsa-z0-9_-). E.g.ci,deploy,ml,infra.
The send key is read only from the NEXTMSG_KEY environment variable, never from tool arguments, so it never passes through the model's context or transcripts.
License
NextMsg MCP questions
What tools does NextMsg MCP provide?
It exposes 1 tool, including macOS.
What tools does the MCP server provide?
The server provides the notify_human tool, which sends a push notification to your phone with support for markdown text and optional channels.