kweenkl MCP Server

Let your AI assistant send you push notifications

Quick Start · Features · Documentation · Examples

🚀 PRE-LAUNCH: kweenkl is currently in pre-launch mode. Join our early access program to get notifications from your AI assistant!

MCP (Model Context Protocol) server that enables AI assistants (Claude, etc.) to send real-time push notifications through kweenkl.

✨ What is kweenkl?

The verb "kweenkl" means to send a notification using kweenkl. When an AI can "kweenkl" you, it transforms from a conversational tool into an active assistant that can tap you on the shoulder when needed.

🎯 Key Features

• 📱 Push Notifications: Send real-time notifications from your AI to your phone

• 🔧 Channel Management: Create, list, update, and delete notification channels

• ⚡ Priority Levels: Set notification priority (low, normal, high)

• 🎨 Customization: Add titles, custom payloads, and metadata

• 🔒 Secure: Token-based authentication

• 🚀 Easy Setup: Works with Claude Desktop and other MCP clients

🆓 Pre-Launch Access

kweenkl is currently in pre-launch. During this phase:

• ✅ The service is fully functional and ready to use

• 🎁 We're gathering feedback from early adopters

• 🚀 Official launch coming soon with more features

Try it now with our demo webhook token: 51fa2b2d-2080-4a73-b059-7e67712d93f7

📦 Installation

Method 1: NPX (Recommended)

Use directly without installation:

Method 2: Clone & Install

⚙️ Configuration

Claude Desktop (macOS)

Edit: ~/Library/Application Support/Claude/claude_desktop_config.json

Basic setup (notifications only):

With channel management (recommended):

Claude Desktop (Windows)

Edit: %APPDATA%\Claude\claude_desktop_config.json

Other MCP Clients

Consult your MCP client's documentation for stdio server configuration. The server requires:

• Node.js executable

• Path to index.js

• Optional environment variables

🌐 Remote MCP Server

For clients that support HTTP Streamable MCP transport (like n8n, ChatGPT, or other automation tools), you can use our hosted MCP server instead of running a local one.

Endpoint: https://api.kweenkl.com/mcp

Authentication:

• For full access (channel management): Include X-Kweenkl-Device-Token header with your device token

• For ChatGPT: Use OAuth flow (contact us for setup)

This allows AI workflows and assistants to send kweenkl notifications without local installation. The remote server supports all the same tools as the local version.

Example n8n configuration:

💬 Usage

Once configured, simply ask your AI assistant natural questions like:

📝 Example Interactions

Basic notification:

With priority:

Contextual notification:

Getting Your Webhook Token

Option 1: Use Demo Token (Pre-Launch)

Try kweenkl immediately with our demo webhook token:

This demo token lets you test the service right away. Notifications sent to this token will be delivered to the kweenkl team's test channel.

Option 2: Get Your Own Token

1. Open kweenkl iOS app (join our TestFlight for pre-launch access)

2. Open a channel

3. Tap info icon

4. Copy webhook token

Environment Variables

• KWEENKL_DEVICE_TOKEN - Your device token for channel management (optional but recommended)

• KWEENKL_API_URL - API base URL (default: https://api.kweenkl.com)

• KWEENKL_DEBUG - Enable debug logging (set to 'true')

🛠️ Tools Available

📨 Core Tool

kweenkl

Send a push notification to a channel

The kweenkl tool accepts the following parameters:

• webhook_token (required): Your channel's webhook token

• message (required): The notification message (max 500 chars recommended)

• title (optional): Brief title for the notification (max 50 chars recommended)

• priority (optional): Priority level - "low", "normal" (default), or "high"

• payload (optional): Custom JSON object for additional metadata

🔧 Channel Management Tools

(requires KWEENKL_DEVICE_TOKEN)

kweenkl_list_channels

📋 List all your notification channels with their webhook URLs

No parameters required

Example usage:

kweenkl_create_channel

➕ Create a new notification channel

Parameters:

• name (required): Channel name

• description (optional): Channel description

• color (optional): Hex color code (e.g., "#FF0000")

• icon (optional): Icon name

Example usage:

kweenkl_update_channel

✏️ Update an existing channel's properties

Parameters:

• channel_id (required): Channel ID to update

• name (optional): New name

• description (optional): New description

• color (optional): New hex color

• icon (optional): New icon name

Example usage:

kweenkl_delete_channel

🗑️ Delete a notification channel permanently

Parameters:

• channel_id (required): Channel ID to delete

Example usage:

Testing

Run the test suite:

Or test manually with the MCP Inspector:

Troubleshooting

📋 Requirements

• Node.js 18+

• Valid kweenkl webhook token

• Internet connection

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT License - see LICENSE file for details

Made with ❤️ by the kweenkl team

Website • GitHub • Issues