Desktop Notification
About
Send cross-platform desktop notifications from AI assistants.
Details
- Author
- gbrigandi
- Categories
- Communication, Other, Productivity
Jump to
Step 1: Locate Claude Configuration File
The configuration file location depends on your operating system:
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json
- Linux:~/.config/Claude/claude_desktop_config.json
Note: If the file doesn't exist, create it with an empty JSON object:{}
Edit the configuration file and add the desktop notification server to themcpServerssection. Replace/path/to/with the actual path where you downloaded the binary.
{ "mcpServers": { "desktop-notify": { "command": "/Users/yourusername/Downloads/mcp-server-desktop-notify", "args": ](https://github.com/gbrigandi/mcp-server-desktop-notify/releases)[] } } }
{ "mcpServers": { "desktop-notify": { "command": "/home/yourusername/bin/mcp-server-desktop-notify", "args": [] } } }
{ "mcpServers": { "desktop-notify": { "command": "C:\\Users\\YourUsername\\Downloads\\mcp-server-desktop-notify.exe", "args": [] } } }
Here's a complete configuration file example with multiple MCP servers:
{ "mcpServers": { "desktop-notify": { "command": "/usr/local/bin/mcp-server-desktop-notify", "args": [] }, } }
- Check file syntax: Ensure your JSON is valid (no trailing commas, proper quotes)
- Verify binary path: Make sure the path to the binary is correct and the file exists
- Check permissions: Ensure the binary is executable (Linux/macOS only)
After saving the configuration file, completely quit and restart Claude Desktop for the changes to take effect.
Once Claude Desktop restarts, you should see the desktop notification tools available. You can verify this by:
- Starting a new conversation with Claude
- Asking Claude: "What notification tools do you have available?"
- Claude should list the desktop notification tools if properly configured
- Use absolute paths: Always use full paths to the binary to avoid issues
- Escape backslashes: On Windows, use double backslashes (\\) in JSON strings
- Test the binary: Run the binary directly first to ensure it works on your system
- Check Claude logs: If issues occur, check Claude Desktop's logs for error messages
Sends periodic notifications every 10 seconds.
Sends desktop notifications with sound when agent tasks are completed.
Allows AI assistants to send native Windows system notifications.
Manage your WhatsApp, SMS and Phone Calls using a single MCP connector
Send Push Notifications and Live Activities to your paired iOS devices.
Connect to any function, any language, across network boundaries using AgentRPC.
Access your meeting transcripts, summaries, and action items from any AI assistant.
Connect Claude, ChatGPT, and other AI tools to your Granola meeting notes via MCP. Query your notes, search transcripts, and get meeting insights in your favorite AI assistants.
Build with the Kudosity API to send SMS and MMS. Access developer docs, API references and live testing tools to send messages, manage contact lists, configure webhooks and more.
A Model Context Protocol (MCP) server that provides cross-platform desktop notification capabilities. Built on top of the excellentnotify-rustcrate, this server allows AI assistants like Claude to send desktop notifications on your behalf, enabling better interaction and feedback during conversations.
- Cross-platform support: Works on Linux (XDG), macOS, and Windows
- Multiple notification types: Basic, urgent, with icons, custom timeouts, and fully customizable
- MCP compliance: Implements the Model Context Protocol for seamless integration
- Flexible configuration: Supports various notification parameters and platform-specific features
- send_notification- Send a simple notification with title and message
- send_urgent_notification- Send a high-priority notification
- send_notification_with_icon- Send a notification with a custom icon
- send_notification_with_timeout- Send a notification with custom timeout
- send_rich_notification- Send a fully customizable notification with all available options
Download the latest binary for your platform from thereleases page:
To use this MCP server with Claude Desktop, you need to add it to your Claude configuration file. This will enable Claude to send desktop notifications during your conversations.
Step 1: Locate Claude Configuration File
The configuration file location depends on your operating system:
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json
- Linux:~/.config/Claude/claude_desktop_config.json
Note: If the file doesn't exist, create it with an empty JSON object:{}
Edit the configuration file and add the desktop notification server to themcpServerssection. Replace/path/to/with the actual path where you downloaded the binary.
{ "mcpServers": { "desktop-notify": { "command": "/Users/yourusername/Downloads/mcp-server-desktop-notify", "args": [] } } }
{ "mcpServers": { "desktop-notify": { "command": "/home/yourusername/bin/mcp-server-desktop-notify", "args": [] } } }
{ "mcpServers": { "desktop-notify": { "command": "C:\\Users\\YourUsername\\Downloads\\mcp-server-desktop-notify.exe", "args": [] } } }
Here's a complete configuration file example with multiple MCP servers:
{ "mcpServers": { "desktop-notify": { "command": "/usr/local/bin/mcp-server-desktop-notify", "args": [] }, } }
- Check file syntax: Ensure your JSON is valid (no trailing commas, proper quotes)
- Verify binary path: Make sure the path to the binary is correct and the file exists
- Check permissions: Ensure the binary is executable (Linux/macOS only)
After saving the configuration file, completely quit and restart Claude Desktop for the changes to take effect.
Once Claude Desktop restarts, you should see the desktop notification tools available. You can verify this by:
- Starting a new conversation with Claude
- Asking Claude: "What notification tools do you have available?"
- Claude should list the desktop notification tools if properly configured
- Use absolute paths: Always use full paths to the binary to avoid issues
- Escape backslashes: On Windows, use double backslashes (\\) in JSON strings
- Test the binary: Run the binary directly first to ensure it works on your system
- Check Claude logs: If issues occur, check Claude Desktop's logs for error messages
Sends periodic notifications every 10 seconds.
Sends desktop notifications with sound when agent tasks are completed.
Allows AI assistants to send native Windows system notifications.
Manage your WhatsApp, SMS and Phone Calls using a single MCP connector
Send Push Notifications and Live Activities to your paired iOS devices.
Connect to any function, any language, across network boundaries using AgentRPC.
Access your meeting transcripts, summaries, and action items from any AI assistant.
Connect Claude, ChatGPT, and other AI tools to your Granola meeting notes via MCP. Query your notes, search transcripts, and get meeting insights in your favorite AI assistants.
Build with the Kudosity API to send SMS and MMS. Access developer docs, API references and live testing tools to send messages, manage contact lists, configure webhooks and more.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
