bark-mcp 0.1.0

MCP server talking to Bark notification server for iOS

bark-mcp

A Model Context Protocol (MCP) server that connects to Bark, a notification server for iOS. This allows LLM applications to send notifications to iOS devices through the MCP standard.

Features

• Simple MCP server implementation using FastMCP
• Single tool: notify to send notifications to iOS devices
• Configurable via environment variables
• Easy to use command-line interface

Installation

# Install from PyPI
pip install bark-mcp

# Or install from source
git clone https://github.com/yourusername/bark-mcp.git
cd bark-mcp
pip install -e .

Configuration

The server requires the following environment variables:

• BARK_SERVER_URL: URL of the Bark server (e.g., https://api.day.app)
• BARK_API_KEY: Your Bark API key/device key

You can set these variables in your environment or create a .env file:

BARK_SERVER_URL=https://api.day.app
BARK_API_KEY=your_api_key_here

Bark API Format

The server uses the Bark API with the following URL formats:

• GET /{bark-key}/{title}/{content}?url={url} (when title and URL are provided)
• GET /{bark-key}/{title}/{content} (when only title is provided)
• GET /{bark-key}/{content} (when only content is provided)

Usage

Command Line

Start the MCP server using either of these commands:

# Using the standard command (after installing the package)
bark-mcp

# Using uvx (runs without installing the package)
uvx bark-mcp

Both commands support the same options:

# Specify a .env file
bark-mcp --env-file /path/to/.env
# or
uvx bark-mcp --env-file /path/to/.env

# Enable debug logging
bark-mcp --debug
# or
uvx bark-mcp --debug

Note: uvx is a command from the uv package manager that runs Python tools in temporary, isolated environments without installing them permanently. Install it with pip install uv.

Using with MCP Clients

The server provides a single tool:

• notify: Send a notification to an iOS device
  • Parameters:
    • title (optional): Title of the notification
    • content (required): Content of the notification
    • url (optional): URL to open when the notification is tapped

Example usage in an MCP client:

# This would be handled by the MCP client
result = await call_tool("notify", {
    "title": "Hello from MCP",
    "content": "This is a notification sent via MCP",
    "url": "https://example.com"
})

Development

Prerequisites

• Python 3.8+
• FastMCP
• Requests
• Python-dotenv

Running Tests

# TODO: Add testing instructions

License

This project is licensed under the MIT License - see the LICENSE file for details.