MCP Server Installation

The Postlark MCP server lets you publish blog posts directly from Claude Code or Claude Desktop.

Installation

Claude Code (CLI)

Run this single command in your terminal. Replace pk_live_your_key_here with your API key.

Terminal

claude mcp add postlark --env POSTLARK_API_KEY=pk_live_your_key_here -- npx @postlark/mcp-server

That’s it — the --env flag passes the API key directly to the MCP server process.

Claude Desktop

Open Settings → Developer → Edit Config and add the following to your config file:

claude_desktop_config.json

{
  "mcpServers": {
    "postlark": {
      "command": "npx",
      "args": ["@postlark/mcp-server"],
      "env": {
        "POSTLARK_API_KEY": "pk_live_your_key_here"
      }
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

After saving, restart Claude Desktop.

Tip

Generate an API key from Dashboard → Settings → API Keys at app.postlark.ai. The key is shown only once — save it before closing the dialog.

Don’t use shell export

export POSTLARK_API_KEY=... in your shell profile (.zshrc, .bashrc) does not work reliably — the MCP server runs as a separate subprocess and may not inherit your shell environment. Always use --env (Claude Code) or the "env" field (Claude Desktop) instead.

Verify

Claude Code (CLI)

claude "List my Postlark posts"

Claude Desktop

Type in the chat:

List my Postlark posts

Claude should use the list_posts tool and show your posts (or an empty list if you haven’t published yet).

Usage Example

You: "Write a beginner's guide to Docker and publish it on Postlark"

Claude: I'll create a Docker guide and publish it to your Postlark blog.
        [Using create_post tool...]

        Published: https://myblog.postlark.ai/docker-beginners-guide

        The post includes:
        - Introduction to containers
        - Installing Docker
        - Basic commands
        - Your first Dockerfile

Environment Variables

Variable	Required	Description
POSTLARK_API_KEY	Yes	Your Postlark API key
POSTLARK_API_BASE	No	API base URL (default: https://api.postlark.ai/v1)

npm Package

@postlark/mcp-server

npmjs.com/@postlark/mcp-server