README.md

April 23, 2026 · View on GitHub

Bark-Worker

License: GPL v3

English | 中文文档

Note

KV Version will probably not support MCP due to limited quota, but if the MCP route can be optimized to some extent, there may have MCP support in KV version.

Note

Batch Push has the highest priority, if device_keys is specified and not empty, device_key will be ignored, in both V1 and V2 APIs.

Bark-Worker is a Bark-Server implenmention on Cloudflare Worker. It provides privacy-aware users with a cheap and private bark backend.

What is Bark?

Bark is an iOS App which allows you to push customed notifications to your iPhone.

Note

A domain is required if worker.dev is unavailable in your country/region

Features

  • Full Bark-Server APIs support
    • register
    • ping
    • healthz
    • info
    • push
  • Path based parameters resolve
  • Easy to deploy, Cheap to use and Convenient to manage

Setup

Note

Select one, D1 or KV Version are both available. D1 Version is recommended for its higher usage than KV Version

Follow the instructions for D1 Version

Note

The Cloudflare API Token must have D1 permission.

Deploy to Cloudflare Workers

Or manually deploy

Refer to Setup Guide

Cloudflare D1 Version

Create a Worker and a D1 Database, bind D1 database to Worker with name database

Cloudflare KV Version

Create a Worker and a KV Storage, bind KV Storage to Worker with name database

Tips

  • Multi Device Key to one Device
  • Device Key Alias
  • D1 Database Manage in Console
  • etc.

Refer to Tips