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

• 14 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-Workspa

... View full README on GitHub