Can I use Beehiiv as a CLI?

Yes. KosmoKrator exposes a Beehiiv CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Beehiiv through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Beehiiv tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Beehiiv credentials stored?

Beehiiv credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Beehiiv MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

newsletter

Beehiiv MCP, CLI, and Lua Integration for AI Agents

Beehiiv integration docs for AI agents: MCP gateway setup, Beehiiv CLI commands, Lua API reference, credentials, and function schemas.

10 functions 6 read 4 write API key auth

Submit Beehiiv feedback View package source

Beehiiv for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: beehiiv
route_slug: beehiiv
package: beehiiv
auth_strategy: api_key API key
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Beehiiv CLIHeadless setup and direct function calls. Beehiiv MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Beehiiv MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Beehiiv.

Claude Code Beehiiv MCP setup for Claude Code. Cursor Beehiiv MCP setup for Cursor. Codex Beehiiv MCP setup for Codex. OpenAI Agents Beehiiv MCP setup for OpenAI Agents SDK. Claude Agent SDK Beehiiv MCP setup for Claude Agent SDK. Vercel AI SDK Beehiiv MCP setup for Vercel AI SDK. LangChain Beehiiv MCP setup for LangChain. LangGraph Beehiiv MCP setup for LangGraph. CrewAI Beehiiv MCP setup for CrewAI. MCP clients Beehiiv MCP setup for Generic MCP Clients.

Beehiiv CLI Matrix

Use these pages for direct Beehiiv CLI workflows in scripts, CI, cron, and agent wrappers.

CI Beehiiv CLI for CI. Cron Jobs Beehiiv CLI for cron jobs. Shell Scripts Beehiiv CLI for shell scripts. Headless Automation Beehiiv CLI for headless automation. Coding Agents Beehiiv CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`beehiiv.beehiiv_list_posts`	Read `read`	3	List posts from your Beehiiv publication. Filter by status (draft, confirmed, etc.) and paginate with limit/page.
`beehiiv.beehiiv_get_post`	Read `read`	1	Get a single post from your Beehiiv publication by its post ID.
`beehiiv.beehiiv_create_post`	Write `write`	7	Create a new post in your Beehiiv publication. Requires title and content. Set status to "draft" to save without publishing, or "confirmed" to publish.
`beehiiv.beehiiv_update_post`	Write `write`	8	Update an existing post in your Beehiiv publication. Provide the post ID and the fields you want to change.
`beehiiv.beehiiv_delete_post`	Write `write`	1	Delete a post from your Beehiiv publication. This action is irreversible.
`beehiiv.beehiiv_list_subscribers`	Read `read`	3	List subscribers for your Beehiiv publication. Filter by status (active, inactive, etc.) and paginate with limit/page.
`beehiiv.beehiiv_get_subscriber`	Read `read`	1	Get a single subscriber from your Beehiiv publication by their subscription ID.
`beehiiv.beehiiv_create_subscriber`	Write `write`	6	Add a new subscriber to your Beehiiv publication by email address.
`beehiiv.beehiiv_get_stats`	Read `read`	4	Get analytics and stats for your Beehiiv publication. Use the "intent" parameter to specify the type of stats (overview, traffic, growth, subscribers).
`beehiiv.beehiiv_get_current_user`	Read `read`	0	Verify your Beehiiv API key and list all publications you have access to. Use this to confirm the integration is working and to find your publication ID.