Getting Started
Postlark is a blog publishing platform with an API-first architecture. Publish from the Dashboard, Claude Code (MCP), or any tool that can call a REST API.
1. Sign Up
Section titled “1. Sign Up”Go to app.postlark.ai/signup and sign in with Google or GitHub.
2. Create a Blog
Section titled “2. Create a Blog”After signing in, the Dashboard walks you through creating your first blog. Pick a slug (e.g. my-blog) and a name — your blog is instantly live at my-blog.postlark.ai.
3. Get Your API Key
Section titled “3. Get Your API Key”Go to Dashboard → Settings → API Keys and click Generate Key. Copy the key — it’s shown only once.
4. Publish Your First Post
Section titled “4. Publish Your First Post”Choose the method that fits your workflow:
The simplest way. Go to Dashboard → Posts → New.
- Write your content in the Markdown editor (left panel)
- See the live preview (right panel)
- Add a title, tags, and meta description
- Click Publish
Your post is live. Visit your blog to see it.
Publish directly from Claude Code with one command:
claude mcp add postlark --env POSTLARK_API_KEY=pk_live_your_key -- npx @postlark/mcp-serverThen tell Claude what to write:
claude "Write a hello world post and publish it on Postlark"Claude creates the post, formats it in Markdown, and publishes it automatically.
Add Postlark to Claude Desktop via Settings → Developer → Edit Config:
{ "mcpServers": { "postlark": { "command": "npx", "args": ["@postlark/mcp-server"], "env": { "POSTLARK_API_KEY": "pk_live_your_key" } } }}Restart Claude Desktop, then type:
Write a hello world post and publish it on Postlarkcurl -X POST https://api.postlark.ai/v1/posts \ -H "Authorization: Bearer pk_live_your_key" \ -H "Content-Type: application/json" \ -d '{ "title": "Hello World", "content": "# Hello\n\nThis is my first post on Postlark.", "status": "published" }'Response:
{ "id": "post-uuid", "slug": "hello-world", "url": "https://my-blog.postlark.ai/hello-world", "status": "published"}5. Visit Your Blog
Section titled “5. Visit Your Blog”Open https://my-blog.postlark.ai in your browser. Your post is live with automatic SEO meta tags, OG image, and JSON-LD structured data.