Skip to content

Installation

This guide will help you install Notify-MCP on your system.

Prerequisites

  • Python 3.11 or higher
  • uv package manager (recommended) or pip

uv is a fast Python package manager that makes installation simple:

curl -LsSf https://astral.sh/uv/install.sh | sh

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Install Notify-MCP

Step 1: Clone the Repository

git clone https://github.com/osick/notify-mcp.git
cd notify-mcp/packages/community

Step 2: Install Dependencies

# Using uv (recommended)
uv sync

# Or using pip
pip install -e .

Step 3: Verify Installation

# Test the server starts
uv run python -m notify_mcp --help

# You should see usage information

Next Steps

Now that Notify-MCP is installed:

  1. Configure Your AI Assistant →
  2. Follow the Quick Start Guide →

Troubleshooting

Python Version Issues

# Check Python version
python --version  # Should be 3.11+

# If too old, install Python 3.11+
# macOS: brew install python@3.11
# Ubuntu: sudo apt install python3.11
# Windows: Download from python.org

uv Not Found

# Add uv to PATH (after installation)
export PATH="$HOME/.cargo/bin:$PATH"

# Or use full path
~/.cargo/bin/uv sync

Permission Errors

# Use virtual environment
python3.11 -m venv .venv
source .venv/bin/activate  # Linux/macOS
# .venv\Scripts\activate  # Windows

pip install -e .

For more help, see the Troubleshooting Guide.