# three.ws Notifications (MCP server)

> three.ws Notifications is an MCP server that adds messaging tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Read the inbox, mark items read, manage delivery preferences, and register Web Push devices. It has 226 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y @three-ws/notifications-mcp.

Your three.ws notification inbox, delivery preferences, and Web Push devices — from any AI agent. A Model Context Protocol server that gives an AI assistant its own three.ws notification inbox + delivery control over stdio. Read inbound events (pump/market alerts, sales & earnings, purchase receipts, social mentions, IRL interactions, account/security notices), mark them read, tune the per-category → per-channel delivery matrix, and register Web Push devices — all live, all account-scoped.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/nirholas/three.ws |
| GitHub stars | 226 |
| License | Apache-2.0 |
| Language | JavaScript |
| Transport | stdio |
| Packages | npm: @three-ws/notifications-mcp |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Communication |
| Latest release | v1.5.2 (Sep 30, 2026) |
| Last commit | Oct 7, 2026 |
| MCP registry name | io.github.nirholas/notifications-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "three-ws-notifications": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/notifications-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env THREE_WS_API_KEY=your-value --transport stdio three-ws-notifications -- npx -y @three-ws/notifications-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "three-ws-notifications": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/notifications-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "three_ws_api_key",
      "description": "THREE_WS_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "three-ws-notifications": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/notifications-mcp"
      ],
      "env": {
        "THREE_WS_API_KEY": "${input:three_ws_api_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `THREE_WS_API_KEY` (secret) (required): A three.ws API key (sklive… / sktest…) or OAuth access token for the account whose notifications you want to read and manage, carried as Authorization…
- `THREE_WS_BASE`: Base URL of the three.ws API. Override only when self-hosting or targeting a preview deployment.
- `THREE_WS_TIMEOUT_MS`: Per-request timeout in milliseconds for the live inbox reads/writes.

## Tools

- `list_notifications`: Read the account's inbox — the inbound-event feed the platform delivers: market/pump alerts, sales & earnings,…
- `type`: string
- `limit`: number
- `mark_read`: Mark notifications read. Wraps POST /api/notifications/:id/read (one) and POST /api/notifications/read-all (all).
- `delete_notification`: Permanently remove one notification. Wraps DELETE /api/notifications/:id.
- `get_preferences`: Read the resolved delivery matrix — for each category, which channels deliver it. No arguments.
- `set_preferences`: Patch the delivery matrix. Wraps PUT /api/notifications/preferences. Provide at least one of the two arguments.
- `categories`: object
- `telegram_chat_id`: string
- `register_push_device`: Register a Web Push device so the account receives push notifications on it. Wraps POST /api/push/subscribe.
- `subscription`: object
- `unregister_push_device`: Remove a Web Push device so it stops receiving pushes. Wraps DELETE /api/push/subscribe.
- `endpoint`: string (URL)

## Similar MCP servers

- [Strata](https://appsgit.com/mcp-servers/strata): MCP server for progressive tool usage at any scale (see https://klavis.ai). (5,807 stars, Apache-2.0, official)
- [Vexa](https://appsgit.com/mcp-servers/vexa): Meeting bot and transcripts for Google Meet, Teams and Zoom. (2,856 stars, Apache-2.0, official, needs API key)
- [MCP Server for WinDbg Crash Analysis](https://appsgit.com/mcp-servers/mcp-server-for-windbg-crash-analysis): A Model Context Protocol server for Windows crash dump analysis using WinDbg/CDB. (1,607 stars, MIT)
- [Rocketmq Rust](https://appsgit.com/mcp-servers/rocketmq-rust): 🚀 Apache RocketMQ built in Rust 🦀 — faster, safer, and more memory-efficient. (1,524 stars, Apache-2.0)
- [Wassette](https://appsgit.com/mcp-servers/wassette): Wassette: A security-oriented runtime that runs WebAssembly Components via MCP. (957 stars, MIT, official)
- [Line Bot MCP Server](https://appsgit.com/mcp-servers/line-bot-mcp-server): MCP server that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account. (783 stars, Apache-2.0, official, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/three-ws-notifications
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.