Alphorn
Gives AI agents a send_notification tool that reaches Slack, Telegram, email or SMS
- 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/mcpAdd 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-myTRequiredALPHORN_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools