Claude Code Notify

Hosts an MCP server for Claude Code notification hooks to enable automated workflows and cross-process integrations.

typescript

3

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "nkyy-claude-code-notify-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/ccnotify/dist/index.js"
      ]
    }
  }
}

You can host Claude Code notification hooks as an MCP server to automate and streamline how Claude Code alerts are delivered to your system. This server handles incoming notifications and lets you run custom workflows or integrate with other tools without modifying Claude Code itself.

How to use

Install and run the MCP server alongside Claude Code to enable automatic enhanced notifications and cross-process control. You will configure a local MCP client to point at this server, then start Claude Code as usual. The server exposes a standard MCP endpoint that your client can connect to, so you can trigger actions from Claude Code notifications or have the server respond to those events with customized behavior.

How to install

Prerequisites you need before installation:

Node.js installed on your machine
npm or npx available in your shell
Access to a terminal or command prompt

Step by step install and run flow you can follow exactly as shown here:

# Method: Manual installation and start
git clone <this-repository>
cd claude-code-notify-mcp
npm install
# If a build step exists, run it
npm run build
# Start the MCP server (stdio) as shown in the example configuration
# Replace with your actual path to dist/index.js if needed
node dist/index.js

Additional configuration and notes

The MCP server can be used in a local setup with a legacy MCP server entry when you want explicit control over the runtime command and arguments.

Troubleshooting

If you encounter issues, verify the server is running and reachable from your MCP client. Check for common problems such as incorrect paths, missing dependencies, or port conflicts.

Available tools

setup-hooks

Automates initial integration by configuring Claude Code to use the MCP server, including installing dependencies and preparing the environment.

build

Builds the MCP server for production use, generating the dist/index.js artifact.

start

Launches the MCP server in production mode so it can accept connections from Claude Code notifications.

dev

Runs the server in development mode with auto-reload for rapid iteration.

test

Executes test suites or validation checks to ensure the MCP endpoint behaves as expected.