mcping

MCPing is a macOS desktop notification MCP server that lets AI assistants push rich notifications to your Mac. Once configured in your MCP client, you can invoke the tool via the standard MCP tooling (for example, by calling the send-notification tool through an AI workflow). The server exposes a single tool, send-notification, which accepts a title and message and can optionally include a subtitle, urgency, sound, and a timeout to control how long the notification stays visible. This enables your AI agents to alert you to build results, server status, reminders, or any custom events with clear formatting on macOS.

Prerequisites:

• Node.js v18 or newer
• macOS (for desktop notifications)

Installation steps:

1. Install Node.js 18+ on your machine if you don’t already have it.
2. Install the MCPing package globally or reference it via npx (as shown in the configuration).

Option A: Quick start (recommended)

• No permanent installation is required in advance; add the MCP server to your MCP client settings as shown below in the Quick Start snippet.

Option B: Manual global install (alternative)

• Run:

npm install -g @toolprint/mcping-mcp@latest
mcping-mcp

After installation, ensure your MCP client is configured to point to the server as described in the Quick Start section.

Tips and common issues:

• Ensure your macOS notifications are allowed for the terminal or the app running your MCP server.
• If notifications don’t appear, check macOS System Preferences > Notifications and verify permission for the terminal or Node process.
• In HTTP mode (development), you can test with curl to POST to http://localhost:3000/mcp with a tools/call payload invoking send-notification.
• The tool supports customization via title, message, subtitle, urgency (low|normal|critical), sound, and timeout (1-60 seconds).
• If you see build or permission errors, verify you’re running on macOS and that you have the required permissions for notifications.