Claude Notification Server

@charles-adedotun

About Claude Notification Server

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

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

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

FAQ from Claude Notification Server

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.

Frequently asked questions

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.

Comments

Basic information

More AI & Agents MCP servers

Open Multi-Agent Canvas

CopilotKit

The open-source multi-agent chat interface that lets you manage multiple agents in one dynamic conversation and add MCP servers for deep research

507

欢迎来到智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797