Enables sending push notifications through the ntfy service with customizable titles, summaries, priority levels, and tags for alerting users about completed tasks or status updates.
Determine Authentication Needs
- If you will use a public topic on the ntfy.sh service, you only need the topic name (no token required).
- If you plan to use a private topic or a self-hosted ntfy server, you’ll need an access token.
Obtain Your ntfy Topic
- Choose a unique string as your topic name. This can be any word or phrase.
- You’ll use this topic both for sending and receiving notifications.
(If Needed) Obtain an ntfy Access Token
- If your topic or server is protected, you need to generate/log in to get an access token.
- For the official ntfy.sh server, follow these steps:
- Go to the ntfy.sh web app.
- Click on the hamburger menu (☰) in the top-left corner.
- Choose "API tokens".
- Log in or sign up if required.
- Create a new token and copy it.
- For self-hosted servers, log in to your server’s UI, find the "API tokens" or "Account" section, and create a token.
(If Needed) Note Your ntfy Server URL
- For the default public server, use:
https://ntfy.sh
- For self-hosted, use your server URL (e.g.,
https://ntfy.yourdomain.com).
Fill In Values in FastMCP
- In the FastMCP connection interface, click the “Install Now” button for ntfy-me-mcp.
- Fill in the required fields:
NTFY_TOPIC: Your chosen topic name.- (Optional)
NTFY_URL: The URL of your ntfy server (omit for default https://ntfy.sh).
- (Optional)
NTFY_TOKEN: Your access token (only if using a protected topic or server).
- (Optional)
PROTECTED_TOPIC: Set to true if your topic requires authentication.
Set Up Your Notification Receiver
- Install the ntfy app on your device.
- Subscribe to your chosen topic (the same string used in
NTFY_TOPIC).
You are now ready to send notifications using the ntfy-me-mcp integration!
