The work it takes off you is the clicking: add a subscriber with the custom fields and campaign tags already attached, or pull the last ten posts with their titles and publish dates, in the same conversation where you were writing about them.
A connector between an AI client and the beehiiv API, covering the three things a newsletter operator touches daily: who is subscribed, what has been published, and which publication you are working in.
- Subscriptions — create one with custom fields and UTM values, or look a subscriber up by email or ID (`beehiiv_create_subscription`)
- Posts — fetch your published newsletters, pull a single post in full, filter by tag, date or audience type
- Publications — list your newsletters, read one publication's stats and settings, and work across several in one session
A beehiiv account with API access. `BEEHIIV_API` holds the key, which starts with `bh-`, and `BEEHIIV_PUBLICATION_ID` pins a publication, which starts with `pub_` — leave that one unset to work across newsletters and name the publication in each request instead. The prebuilt binary from the Releases page needs nothing else installed; building from source needs Java 21+ and the bundled `./mvnw`. Set `LOGGING_LEVEL_ROOT=DEBUG` when a call fails and you need to see why.
One command plus a key — curl -fsSL https://raw.githubusercontent.com/danvega/beehiiv-mcp-server/main/scripts/install.sh | bash, then supply credentials