@nasmcps/bark-mcp

MCP Server for sending push notifications to iOS devices via Bark.

Installation

npm install -g @nasmcps/bark-mcp

Or use directly with npx:

npx @nasmcps/bark-mcp

Configuration

Before using this MCP server, you need to:

1. Install the Bark app on your iOS device
2. Get your device key from the app
3. Optionally, set environment variables:

# Set default device key (recommended, so you don't need to provide it every time)
export BARK_DEVICE_KEY="your_device_key_here"

# Optional: set a custom Bark server URL
export BARK_BASE_URL="https://api.day.app"  # Default
# Or your self-hosted server
export BARK_BASE_URL="https://your-bark-server.com"

MCP Server Configuration

Add to your MCP client configuration (usually in ~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "bark": {
      "command": "npx",
      "args": ["@nasmcps/bark-mcp"],
      "env": {
        "BARK_DEVICE_KEY": "your_device_key_here",
        "BARK_BASE_URL": "https://api.day.app"
      }
    }
  }
}

Available Tools

push

Send a push notification to your iOS device.

Required parameters:

• title - Notification title
• body - Notification message

Optional parameters:

• deviceKey - Your Bark device key (can be omitted if BARK_DEVICE_KEY env var is set)

Optional parameters:

• sound - Notification sound (see list_sounds for available options)
• badge - Badge number to display on app icon
• icon - URL of icon image for the notification
• group - Notification group name
• group - Notification group name
• url - URL to open when notification is tapped
• copy - Content to copy when notification is tapped
• level - Notification interruption level: "passive", "active", or "timeSensitive"

list_sounds

List all available Bark notification sounds.

Usage Example

Once configured, you can use the tools through Claude:

"Send me a push notification with title 'Hello' and body 'This is a test'"

"Show me all available notification sounds"

"Send a push with title 'Alert' and body 'Important message', use the 'bell' sound and set the URL to https://example.com"

If you haven't set BARK_DEVICE_KEY environment variable, you'll need to provide the device key:

"Send a push notification with title 'Hello', body 'This is a test', and device key 'your_key_here'"

License

MIT