Skip to content
MCP server

Alphorn

Gives AI agents a send_notification tool that reaches Slack, Telegram, email or SMS

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, Slack, telegram
Runs
Locally
Version
0.1.1
Listing updated
2 days ago

About Alphorn

Alphorn is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

Hooks fire on fixed events, but this server lets the agent decide when something deserves a ping: a long task finishing, a blocked decision, or a request to tell you. It exposes one tool, send_notification, and posts to a webhook you create in Alphorn.

The tool takes a required message of up to 4,000 characters, plus an optional title, a priority from 1 to 5 and tags. The suggested priorities are 2 for finished, 3 for needs input, 4 for blocked or failed and 5 for urgent. Filters in Alphorn then route by priority or tag, for example SMS only for priority 4 and above, or completed tasks to Slack. On errors such as an invalid key, a disabled webhook or an exhausted quota, the tool explains the problem so the agent can report it instead of retrying.

The package @alphorn/mcp runs locally through npx on Node.js 20 or later. It works with hosted Alphorn or a self-hosted instance, and is AGPL-3.0-or-later.

Install

Run in a terminal

claude mcp add mcp --env ALPHORN_WEBHOOK_URL='<ALPHORN_WEBHOOK_URL>' --env ALPHORN_API_KEY='<ALPHORN_API_KEY>' -- npx -y @alphorn/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alphorn/mcp"
      ],
      "env": {
        "ALPHORN_WEBHOOK_URL": "<ALPHORN_WEBHOOK_URL>",
        "ALPHORN_API_KEY": "<ALPHORN_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alphorn/mcp"
      ],
      "env": {
        "ALPHORN_WEBHOOK_URL": "<ALPHORN_WEBHOOK_URL>",
        "ALPHORN_API_KEY": "<ALPHORN_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@alphorn/mcp"
      ],
      "env": {
        "ALPHORN_WEBHOOK_URL": "<ALPHORN_WEBHOOK_URL>",
        "ALPHORN_API_KEY": "<ALPHORN_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alphorn/mcp"
      ],
      "env": {
        "ALPHORN_WEBHOOK_URL": "<ALPHORN_WEBHOOK_URL>",
        "ALPHORN_API_KEY": "<ALPHORN_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alphorn/mcp"
      ],
      "env": {
        "ALPHORN_WEBHOOK_URL": "<ALPHORN_WEBHOOK_URL>",
        "ALPHORN_API_KEY": "<ALPHORN_API_KEY>"
      }
    }
  }
}

Configuration

  • ALPHORN_WEBHOOK_URLWebhook Endpoint URL, e.g. https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myTRequired
  • ALPHORN_API_KEYWebhook API key (alp_...), if the webhook requires one

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

send_notification
Sends a message with optional title, priority and tags through an Alphorn webhook.

What it does

Agent-decided alerts
The agent chooses when to notify, rather than waiting for a fixed hook event.
Priority levels
Priorities 2 to 5 mark finished, needs input, blocked or failed, and urgent.
Tag-based routing
Tags let Alphorn filters send different messages to different channels.
Plain-language errors
Invalid keys, disabled webhooks and exhausted quotas are reported clearly.
Claude Desktop bundle
A one-click alphorn.mcpb bundle asks for the endpoint URL and key.
Self-hosting support
Points at hosted Alphorn or your own instance's base URL.

Good for

  • Get an SMS when a coding agent is blocked
  • Post a Slack message when a long task finishes
  • Route urgent agent alerts to a different channel than routine ones
  • Notify yourself from Claude Code, Cursor or Codex overnight runs

Pricing

Open source

Server is AGPL-3.0-or-later; hosted Alphorn plan prices not published

Prices change. Check docs.alphorn.dev before you buy.

Alphorn FAQ

What do I need to configure?

An Alphorn webhook Endpoint URL as ALPHORN_WEBHOOK_URL, and ALPHORN_API_KEY if the webhook requires a key.

Which clients are covered?

The docs give setup for Claude Code, Claude Desktop, Cursor and Codex CLI, and say any MCP client works.

Which channels can it notify?

The README lists Slack, Telegram, Discord, email, SMS and push, depending on what you configure in Alphorn.

What Node version is needed?

Node.js 20 or later.

Is Alphorn free?

Yes. Alphorn is open source, so you can use and self-host it for free.

How do I add Alphorn to Claude Code?

Run this command in your terminal: claude mcp add mcp --env ALPHORN_WEBHOOK_URL='<ALPHORN_WEBHOOK_URL>' --env ALPHORN_API_KEY='<ALPHORN_API_KEY>' -- npx -y @alphorn/mcp

What are the best alternatives to Alphorn?

The closest alternatives to Alphorn are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Alphorn

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools