three.ws Notifications
Read the inbox, mark items read, manage delivery preferences, and register Web Push…
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.1.4
- Listing updated
- 5 days ago
About three.ws Notifications
three.ws Notifications is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Read the inbox, mark items read, manage delivery preferences, and register Web Push devices.
Install
Run in a terminal
claude mcp add notifications-mcp --env THREE_WS_API_KEY='<THREE_WS_API_KEY>' -- npx -y @three-ws/notifications-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"notifications-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/notifications-mcp"
],
"env": {
"THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"notifications-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/notifications-mcp"
],
"env": {
"THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"notifications-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/notifications-mcp"
],
"env": {
"THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"notifications-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/notifications-mcp"
],
"env": {
"THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"notifications-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/notifications-mcp"
],
"env": {
"THREE_WS_API_KEY": "<THREE_WS_API_KEY>"
}
}
}
}Configuration
THREE_WS_API_KEYA three.ws API key (sk_live_… / sk_test_…) or OAuth access token for the account whose notifications you want to read and manage, carried as Authorization: Bearer. Required — every endpoint is account-scoped. Aliases: THREE_WS_TOKEN, THREE_WS_BEARER. Treat like a password.RequiredTHREE_WS_BASEBase URL of the three.ws API. Override only when self-hosting or targeting a preview deployment.THREE_WS_TIMEOUT_MSPer-request timeout in milliseconds for the live inbox reads/writes.
Pricing
Open source
Prices change. Check three.ws before you buy.
three.ws Notifications FAQ
Is three.ws Notifications free?
Yes. three.ws Notifications is open source, so you can use and self-host it for free.
How do I add three.ws Notifications to Claude Code?
Run this command in your terminal: claude mcp add notifications-mcp --env THREE_WS_API_KEY='<THREE_WS_API_KEY>' -- npx -y @three-ws/notifications-mcp