Publer MCP Server

An open-source Model Context Protocol (MCP) server for the Publer social media management API.

Schedule posts, upload media, pull analytics, and manage accounts across 15+ social networks — all from your AI assistant.

Created by Kess Media

Features

• 18 tools covering the full Publer API

• Create, schedule, publish, update, and delete posts

• Upload media via URL (perfect for Dropbox/cloud storage integration)

• Browse and search media library

• Analytics: charts, post insights, hashtag analysis, best times to post

• Multi-account posting across Facebook, Instagram, X, LinkedIn, TikTok, YouTube, Bluesky, and more

• Async job polling for post creation and media uploads

Requirements

• Node.js 18+

• Publer Business plan (API access is Business-only)

• Publer API key (Settings → Access & Login → API Keys)

Quick Start

Claude Desktop App / Claude Code Desktop (Mac)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "publer": {
      "command": "npx",
      "args": ["-y", "publer-mcp-server"],
      "env": {
        "PUBLER_API_KEY": "your-api-key-here",
        "PUBLER_WORKSPACE_ID": "your-workspace-id-here"
      }
    }
  }
}

Restart the app — Publer will appear under Connectors → Desktop.

Claude Code (CLI)

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "publer": {
      "command": "npx",
      "args": ["-y", "publer-mcp-server"],
      "env": {
        "PUBLER_API_KEY": "your-api-key-here",
        "PUBLER_WORKSPACE_ID": "your-workspace-id-here"
      }
    }
  }
}

Or via the CLI:

claude mcp add publer -- npx -y publer-mcp-server \
  --env PUBLER_API_KEY=your-key \
  --env PUBLER_WORKSPACE_ID=your-workspace-id

Cloudflare Worker (Remote — No Local Install)

Deploy as a Cloudflare Worker and connect from any Claude interface without installing anything locally. One deployment, multiple users.

Deploy:

git clone https://github.com/alexkess/publer-mcp-server.git
cd publer-mcp-server/worker
npm install
npx wrangler deploy
npx wrangler secret put PUBLER_API_KEY
npx wrangler secret put PUBLER_WORKSPACE_ID

Your server is now live at https://publer-mcp.<your-subdomain>.workers.dev/mcp.

Connect from Claude Code (~/.claude/mcp.json):

{
  "mcpServers": {
    "publer": {
      "type": "http",
      "url": "https://publer-mcp.<your-subdomain>.workers.dev/mcp"
    }
  }
}

Connect from Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

The Desktop app's Connectors UI doesn't support custom HTTP MCP servers directly. Use the Claude Code config above, or add the URL via the custom connector flow in Settings → Connectors → +.

Security note: The Worker URL acts as your access credential — keep it private. Each user deploys their own Worker with their own Publer API key, so there's no shared access risk.

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "publer": {
      "command": "npx",
      "args": ["-y", "publer-mcp-server"],
      "env": {
        "PUBLER_API_KEY": "your-api-key-here",
        "PUBLER_WORKSPACE_ID": "your-workspace-id-here"
      }
    }
  }
}

Environment Variables

Finding Your Workspace ID

Option 1: From the API

curl -H "Authorization: Bearer-API YOUR_API_KEY" https://app.publer.com/api/v1/me

Your workspace IDs are in the workspaces array in the response.

Option 2: From the Publer URL

Log in to Publer, open your browser's developer tools (F12), go to the Network tab, and look for any API request — the Publer-Workspace-Id header shows your workspace ID.

Available Tools

Account Management

Posts

Media

Jobs

Analytics

Example Workflows

Schedule a photo post

"Upload this image from my Dropbox to Publer, then schedule it 
to my Alex Kess Bluesky account for Thursday at 10am AEST 
with the caption 'Cronulla from above.'"

The AI assistant will:

1. Call publer_upload_media_from_url with the Dropbox link

2. Poll publer_get_job_status until the upload completes

3. Call publer_create_post with the media ID, caption, account ID, and scheduled time

Check post performance

"How did my posts perform last week on Instagram?"

The AI assistant will:

1. Call publer_list_accounts to find the Instagram account ID

2. Call publer_get_post_insights with the date range

3. Present the results

Label posts for a campaign

"Create a draft post for next month's launch and label it 'launch-q3'."

The AI assistant will:

1. Call publer_list_accounts to find the target account ID

2. Call publer_create_post with state: "draft" and labels: ["launch-q3"]

3. Call publer_get_post after the async job completes to inspect the saved labels

Publer documents labels on create/schedule requests. Existing draft labels are not updatable via the documented API; live tests showed label update payloads return success but do not persist. To relabel an existing draft, ask the user before recreating it with labels and deleting the original, because that changes the post ID and may not preserve every internal Publer field.

Development

git clone https://github.com/alexkess/publer-mcp-server.git
cd publer-mcp-server
npm install
npm run build

Run locally

PUBLER_API_KEY=your-key PUBLER_WORKSPACE_ID=your-id npm start

Supported Networks

Facebook, Instagram, X (Twitter), LinkedIn, Pinterest, YouTube, TikTok, Google Business Profile, WordPress, Telegram, Mastodon, Threads, Bluesky.

License

MIT — see LICENSE

Contributing

PRs welcome! This is an open-source project by Kess Media.