# ntfy-mcp

> MCP Server

Ntfy-mcp is an MCP server that sends ntfy notifications when AI assistant tasks are completed, allowing users to stay informed without constant monitoring. It integrates with the Model Context Protocol

## Overview

- **Category:** Developer Tools
- **Language:** JavaScript
- **Stars:** 44
- **Forks:** 0
- **Owner:** teddyzxcv
- **GitHub:** https://github.com/teddyzxcv/ntfy-mcp
- **Created:** 2025-03-18T19:31:16+00:00
- **Updated:** 2025-03-25T01:28:17+00:00
- **Source:** https://model-context-protocol.com/servers/ntfy-ai-assistant-task-notifications

## Setup

## Setup

**Step 1: Clone & Navigate**
```bash
git clone https://github.com/teddyzxcv/ntfy-mcp.git
cd ntfy-mcp
```

**Step 2: Install**
```bash
npm install
```

**Step 3: Build**
```bash
npm run build
```

**Step 4: Connect**
Choose your adventure:

**Manual Start:**
```bash
npm start
```

**Cline Configuration:**
```json
"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](https://ntfy.sh) 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**


## Tools

## Available Tools

1.  ntfy notifications (Sends notifications via ntfy when tasks are completed).
2.  Model Context Protocol integration (Integrates seamlessly with the Model Context Protocol).
3.  Cline Configuration (Allows configuration via Cline with specific commands and environment variables).
4.  Manual Start (Allows starting the server manually using `npm start`).