ntfy-mcp: Your Friendly Task Completion Notifier

by teddyzxcv

44 stars

431 downloads

Not rated

GitHub

Productivity

Description

# ntfy-mcp: Your Friendly Task Completion Notifier Welcome to ntfy-mcp, the MCP server that keeps you caffeinated and informed! 🚀☕️ This handy little server integrates with the Model Context Protocol to send you delightful ntfy notifications whenever your AI assistant completes…

About

Details

Author: teddyzxcv
GitHub stars: 44
Downloads: 431
Categories: Productivity

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name ntfy-mcp: Your Friendly Task Completion Notifier

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

From the repository

Clone the repository, run npm install and npm run build, then configure the server in your MCP client (e.g., Cline) with the node command pointing to the built index.js and the NTFY_TOPIC environment variable set to your chosen ntfy topic. Finally, subscribe to that topic in the ntfy mobile app and instruct your AI assistant to notify you when the task is done.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ntfy-mcp: your friendly task completion notifier": {
            "ntfy-mcp": {
                "command": "node",
                "args": [
                    "/path/to/repo/MCP/ntfy-mcp/build/index.js"
                ],
                "env": {
                    "NTFY_TOPIC": "<your topic name>"
                },
                "disabled": false,
                "autoApprove": [
                    "notify_user"
                ]
            }
        }
    }
}

McpServers

{
    "ntfy-mcp": {
        "command": "node",
        "args": [
            "/path/to/repo/MCP/ntfy-mcp/build/index.js"
        ],
        "env": {
            "NTFY_TOPIC": "<your topic name>"
        },
        "disabled": false,
        "autoApprove": [
            "notify_user"
        ]
    }
}

ntfy-mcp: Your Friendly Task Completion Notifier

Welcome to ntfy-mcp, the MCP server that keeps you caffeinated and informed! 🚀☕️

This handy little server integrates with the Model Context Protocol to send you delightful ntfy notifications whenever your AI assistant completes a task. Because let's face it - you deserve that tea break while your code writes itself.

Getting Started: The Quick Brew Guide

Step 1: Clone & Navigate

git clone https://github.com/teddyzxcv/ntfy-mcp.git
cd ntfy-mcp

Step 2: Install

npm install

Step 3: Build

npm run build

Step 4: Connect

Choose your adventure:

Manual Start:

npm start

Cline Configuration:

"ntfy-mcp": {

  "command": "node",

  "args": [

    "/path/to/ntfy-mcp/build/index.js"

  ],

  "env": {

    "NTFY_TOPIC": "<your topic name>"

  },

  "autoApprove": [

    "notify_user" // Highly recommended for maximum chill

  ]

}

Step 5: Get Notified in Style

1. Download the ntfy app on your phone 2. Subscribe to your chosen topic 3. Kick back and relax

Step 6: The Magic Command

Write a prompt like this, otherwise the function won't call (tried use Custom Instructions in cline, but they are in the ring 3, so model just forget about it)

Write me a hello world in python, notify me when the task is done

Step 7: Enjoy Your Beverage of Choice

☕️🍵 Your notification will arrive when the task is complete. No peeking!

How It Works (The Technical Tea)

This MCP server integrates seamlessly with the Model Context Protocol, acting as your personal notification butler. When tasks are completed, it sends notifications via ntfy, keeping you informed without interrupting your flow.

Dependencies: The Secret Sauce

- @modelcontextprotocol/sdk
- node-fetch
- dotenv
- zod

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Copyright 2025 Casey Hand @cyanheads Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

---

Now go forth and code with confidence, knowing your notifications are in good hands! 🎉

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

ntfy-mcp: Your Friendly Task Completion Notifier

Getting Started: The Quick Brew Guide

Step 1: Clone & Navigate

Step 2: Install

Step 3: Build

Step 4: Connect

Step 5: Get Notified in Style

Step 6: The Magic Command

Step 7: Enjoy Your Beverage of Choice

How It Works (The Technical Tea)

Dependencies: The Secret Sauce

License

Install

More like this

Time

Github SSE

Npx Y convex@latest mcp start

Inbox Zero

Lamda

Windows-MCP