Jon's Pushover MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Jon's Pushover MCP Server send a notification that says 'Meeting starts in 5 minutes' with title 'Team Standup'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Jon's Pushover MCP Server
An MCP server for sending push notifications via Pushover.
Requirements
Python 3.10+
Pushover account with API token and user key
Related MCP server: MCP-Pushover Bridge
Environment Variables
Variable | Required | Description |
| Yes | Application API token from https://pushover.net/apps |
| Yes | User key from https://pushover.net |
Installation
# Clone the repository
git clone <your-repo-url>
cd jons-mcp-pushover
# Install with uv
uv pip install -e .Running the Server
uv run jons-mcp-pushoverClaude Desktop Configuration
Add this to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"pushover": {
"command": "uv",
"args": ["run", "--project", "/path/to/jons-mcp-pushover", "jons-mcp-pushover"],
"env": {
"PUSHOVER_API_TOKEN": "your-api-token-here",
"PUSHOVER_USER_KEY": "your-user-key-here"
}
}
}
}Adding to Claude Code
# Register the MCP server with Claude Code
claude mcp add jons-mcp-pushover \
-e PUSHOVER_API_TOKEN=your-api-token-here \
-e PUSHOVER_USER_KEY=your-user-key-here \
-- uv run --directory /path/to/jons-mcp-pushover jons-mcp-pushoverAvailable Tools
send_notification
Send a push notification to your devices.
Parameter | Type | Required | Default | Description |
| string | Yes | - | The notification message body |
| string | No | App name | Title shown at top of notification |
| string | No | - | URL to include (tappable in notification) |
| string | No | - | Label for the URL |
| integer | No | 0 | Priority: -2 (silent) to 2 (emergency) |
| string | No | device default | Notification sound name |
Example:
send_notification(
message="Build completed successfully!",
title="CI Pipeline",
url="https://github.com/user/repo/actions",
url_title="View Build",
priority=1,
sound="magic"
)Development
Setup
# Install with dev dependencies
uv pip install -e ".[dev]"Running Tests
# Run all tests
uv run pytest
# Run with coverage
uv run pytest --cov=src
# Run a specific test
uv run pytest tests/test_pushover.py::test_send_notification_successCode Quality
# Type check
uv run mypy src/jons_mcp_pushover
# Format code
uv run black src tests
# Lint code
uv run ruff check src testsProject Structure
jons-mcp-pushover/
├── src/
│ ├── __init__.py
│ └── jons_mcp_pushover/
│ ├── __init__.py # Package exports
│ ├── constants.py # Configuration constants
│ ├── exceptions.py # Custom exceptions
│ ├── utils.py # Utility functions
│ ├── server.py # FastMCP server setup
│ └── tools/
│ ├── __init__.py # Tool exports
│ └── pushover.py # Pushover notification tool
├── tests/
│ ├── conftest.py # Test fixtures
│ └── test_pushover.py # Pushover tool tests
├── pyproject.toml # Project configuration
├── CLAUDE.md # AI assistant guidance
└── README.md # This fileAdding New Tools
Create a new file in
src/jons_mcp_pushover/tools/or add to an existing fileWrite an async function with type hints and a docstring:
async def my_tool(param: str) -> str: """Brief description for the MCP tool listing. Args: param: What this parameter does. Returns: What the tool returns. """ return f"Result: {param}"Export from
src/jons_mcp_pushover/tools/__init__.pyRegister in
server.pywithmcp.tool(my_tool)
License
MIT
Available Tools
1 toolsend_notificationA
Send a push notification via Pushover.
Args: message: The notification message body (required). title: Title shown at top of notification. Defaults to app name. url: URL to include (tappable in notification). url_title: Label for the URL instead of showing raw URL. priority: Priority level from -2 (silent) to 2 (emergency). Default 0. sound: Notification sound name. See Pushover docs for available sounds.
Returns: Dictionary with 'status' (1 for success) and 'request' (UUID string).
Raises: ValueError: If priority is out of range or sound is invalid. PushoverError: If Pushover API returns an error or credentials are missing.
Inputs: message (required), title, url, url_title, +2 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The tool 'send_notification' has a clear, singular purpose that is distinct by default.
The single tool name 'send_notification' follows a clear verb_noun pattern, and with only one tool, consistency is inherently perfect as there are no other names to compare against.
A single tool is too few for most server purposes, as it limits functionality and suggests a thin or incomplete surface. For a notification service, basic operations like listing or managing notifications might be expected, but only sending is provided.
The server's domain appears to be Pushover notifications, but it only offers a send operation. There are significant gaps, such as no ability to retrieve, update, delete, or list notifications, which could cause agent failures in broader workflows.
Maintenance
Related MCP Connectors
Push notifications for AI agents - send instant iPhone notifications from any MCP client.
Push notifications with personalized sounds - manage and trigger your vybits via MCP
Send yourself a push notification from an AI assistant. No account, one environment variable.
Let agents send content-free push notifications to a paired phone via MCP.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA Model Context Protocol implementation that enables AI agents to send notifications through Pushover.net, supporting message customization with various parameters like priority, sound, and URL.94 npm43MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to send push notifications to mobile devices via Pushover, allowing users to receive instant alerts for task completions, errors, reminders, and custom messages through their AI conversations.16 npm2MIT
- AlicenseAqualityDmaintenanceA tiny MCP server that sends push notifications through Pushover, supporting message, title, priority, sound, URL, and device parameters.11MIT

PushPlus MCP Serverofficial
AlicenseBqualityBmaintenanceEnables AI assistants to send push notifications to WeChat, email, and other channels via PushPlus, supporting multiple message formats and channels.10721 npm4MIT