home / mcp / kweenkl mcp server

Kweenkl MCP Server

Push-notification MCP server enabling AI assistants to deliver real-time alerts, manage channels, and control notification priority.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "antoinedelorme-kweenkl-mcp": {
      "url": "https://api.kweenkl.com/mcp",
      "headers": {
        "KWEENKL_DEBUG": "true",
        "KWEENKL_API_URL": "https://api.kweenkl.com",
        "KWEENKL_DEVICE_TOKEN": "your-device-token-here"
      }
    }
  }
}

You can use the kweenkl MCP Server to enable AI assistants to send real-time push notifications to your devices. It supports managing notification channels, prioritizing messages, and securely authenticating via tokens, so your AI workflows can actively alert you when important events happen.

How to use

Set up the MCP server locally or connect to the remote MCP endpoint to start sending notifications from your AI assistant. You can trigger notifications using simple, natural language prompts such as asking to notify you when a process completes, sending a high-priority alert, or sharing a summary of a result. Use the available channel management tools to create and configure channels, then send messages with the core notification tool. If you are using Claude Desktop or another MCP client, configure the client to point to either your local server or the hosted endpoint, then start sending kweenkl requests just like you would ask for other actions from your AI.

How to install

Prerequisites: you need Node.js 18 or newer and internet access. You may also want a token for channel management if you plan to set up channels with your device.

{
  "mcpServers": {
    "kweenkl": {
      "command": "npx",
      "args": ["-y", "kweenkl-mcp-server"]
    }
  }
}

Additional setup from local or remote endpoints

Option A: Run a local MCP server via NPX (recommended for quick starts). This does not require a full clone and install. You run the MCP server directly with NPX and let it execute from the package registry.

npx -y kweenkl-mcp-server

Clone and install the local server (optional)

If you prefer to clone the source and run it locally, you can install dependencies and start the server from your checkout.

git clone https://github.com/antoinedelorme/kweenkl-mcp.git
cd kweenkl-mcp
npm install

Start the local server

Once dependencies are installed, start the server using the runtime you prefer. The examples show common approaches you might use in your environment.

node /absolute/path/to/kweenkl-mcp-server/index.js

Available tools

kweenkl

Send a push notification to a channel by providing webhook_token, message, and optional title, priority, and payload.

kweenkl_list_channels

List all notification channels with their webhook URLs and notification counts; requires device token for authentication.

kweenkl_create_channel

Create a new notification channel with a name and optional properties like description, color, and icon.

kweenkl_update_channel

Update an existing channel's properties such as name, description, color, or icon.

kweenkl_delete_channel

Delete a notification channel permanently using its channel_id.