Advertise
MCP.so
Sign In

Claude Notification Server MCP Server

@charles-adedotun

Repository

Basic information

Category

AI & Agents

License

MIT

Transports

stdio

Author

charles-adedotun

About 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 config

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

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

Claude Notification Server MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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.

Frequently asked questions

1

What platforms does Claude Notification Server support?

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

2

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`.

3

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.

4

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.

5

What command do I use in Claude Desktop configuration?

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

Comments

More AI & Agents MCP servers

BlazingCDN MCP - Content Delivery for Video, Software & Static Files

BlazingCDN

Official MCP server for BlazingCDN - AI agents (Claude, Cursor, Windsurf) manage CDN resources, purge cache, query metrics, domains, Anycast CDN, Video CDN and Media CDN

1

TruVerifAI Panel-review

TruVerifAI

TruVerifAI's Panel Review is the guardian agent for AI's highest-stakes coding decisions: four frontier models argue over an AI coding agent's riskiest designs, diffs, and commits before they execute, with local review g

1

scvd.store

seancrecord

scvd.store is an evidence observatory for agentic commerce. Independent signed observation of what other people's endpoints, artifacts and payments actually did among other things. USDC on Base, Arbitrum One, World Chain

2

Agentic Atlas

Avery Jones

Consult field-tested agent-system design patterns through 8 hosted, read-only tools for orientation, deep reading, relationships, provenance, glossary terms, and publication decisions.

L

Legion MCP

faulkj

MCP-native LLM councils for debates, juries, blind panels, voting, refinement, and custom multi-model deliberation.

1
Advertise