Claude Notification Server MCP Server

@charles-adedotun

代码仓库

基本信息

分类

AI 与智能体

许可证

MIT

传输方式

stdio

作者

charles-adedotun

关于 Claude Notification Server MCP Server

MCP server for macOS notifications and sounds when Claude Desktop tasks complete.

#macos #mcp #claude#notification-system#llm-tools

Claude Notification Server MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "notifications-mcp-server": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "-e",
        "."
      ]
    }
  }
}

Claude Notification Server MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Claude Notification Server?

Claude Notification Server is a macOS-focused MCP server that lets Claude Desktop or any MCP client trigger sound and visual notifications through a single task_status tool. It plays macOS system sounds and delivers visual alerts using terminal-notifier, AppleScript, PyObjC, or pync fallbacks.

How to use Claude Notification Server?

Install the package with pip install notifications-mcp-server. Optionally install visual dependencies with pip install "notifications-mcp-server[visual]" and (for terminal-notifier) run brew install terminal-notifier. Configure Claude Desktop to run the console script claude-notifications. Customize behavior with environment variables CLAUDE_START_SOUND, CLAUDE_COMPLETE_SOUND, CLAUDE_VISUAL_NOTIFICATIONS, and CLAUDE_NOTIFICATION_ICON.

Key features of Claude Notification Server

Registers a task_status MCP tool.
Plays macOS system sounds with afplay.
Sends visual notifications using multiple fallback methods.
Supports separate start and completion sounds.
Supports disabling visual notifications via an environment variable.
Includes tests for the modular notification and sound managers.

Use cases of Claude Notification Server

Notify the user when a long-running task in Claude Desktop finishes.
Alert the user when a processing step starts.
Integrate with Claude Desktop to get audio and visual feedback for tool calls.

常见问题

What platforms does Claude Notification Server support?

Only macOS is supported. Linux and Windows are not implemented.

How do I install optional visual notification dependencies?

Run `pip install "notifications-mcp-server[visual]"` for PyObjC, or `pip install "notifications-mcp-server[pync]"` for pync. For terminal-notifier, install via Homebrew with `brew install terminal-notifier`.

Can I customize the notification sounds?

Yes. Set the `CLAUDE_START_SOUND` and `CLAUDE_COMPLETE_SOUND` environment variables to the path of any `.aiff` or `.wav` file. If not set, default macOS system sounds are used.

When do notifications actually trigger?

Notifications only fire when an MCP client or model calls the `task_status` tool. The server is not an automatic completion detector.

What command do I use in Claude Desktop configuration?

Use `"command": "claude-notifications"`. This is the console script installed by the Python package.

AI 与智能体分类下的更多 MCP 服务器

GetIntel

tarang8811

Public docs + tool manifest for the GetIntel MCP connector (app.getintel.ai)

Singularis

oov1317

Singularis is unlimited computation. Bring us your hardest problems. MCP server; free agent key: 500 credits instantly.

fhirHydrant

faulkj

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.

Lumify Sports Intelligence

Lumify

Agent-ready sports intelligence API: live scores, odds, line movement, public betting splits, and explainable bet confidence — via 16 MCP tools at https://lumify.ai/mcp. Get a free key instantly — no signup, email, or ca

q-ring

I4cTime

Quantum-inspired keyring for AI coding agents. Secure secrets with superposition, entanglement, tunneling, and teleportation — CLI + 44 MCP tools.