drio
Open app

Ntfy MCP Server

Source

An MCP (Model Context Protocol) server designed to interact with the ntfy push notification service. It enables LLMs and AI agents to send notifications to your devices with extensive customization options.

Catalog onlyCatalog onlySTDIO

Overview

MCP TypeScript Template is a foundational template for building Model Context Protocol (MCP) servers using TypeScript, enabling AI systems to interact with external tools and resources.

To use this template, clone the repository, install the dependencies, build the project, and start the server. You can then customize it to create your own MCP server.

  • Utilities: Includes reusable utilities for logging, error handling, ID generation, and more. - Type Safety: Strong typing with TypeScript to catch errors at compile time. - Security: Built-in security features to protect against common vulnerabilities. - Documentation: Comprehensive documentation with usage examples. - Example Implementations: Working examples of tools and resources to help you get started quickly.
  1. Building custom MCP servers for AI applications.
  2. Implementing tools that can be executed by AI systems.
  3. Creating resources that provide structured information to AI models.

Add to your AI client

Use these steps to connect Ntfy MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "ntfy-mcp-server-cyanheads": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-ntfy-mcp-server-cyanheads"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "ntfy-mcp-server-cyanheads": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-ntfy-mcp-server-cyanheads"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "ntfy-mcp-server-cyanheads": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-ntfy-mcp-server-cyanheads"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "ntfy-mcp-server-cyanheads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-ntfy-mcp-server-cyanheads"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ntfy-mcp-server-cyanheads": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-ntfy-mcp-server-cyanheads"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "ntfy-mcp-server-cyanheads": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-ntfy-mcp-server-cyanheads"
      ]
    }
  }
}

FAQ

**What is Model Context Protocol?**

Model Context Protocol (MCP) is a framework that allows AI systems to execute tools and access structured resources.

**Is this template suitable for beginners?**

Yes! It is designed to be beginner-friendly with comprehensive documentation and examples.

**What technologies are used in this template?**

The template is built using TypeScript and follows modern development practices.