Publer MCP Server

An MCP (Model Context Protocol) server that wraps the Publer social media scheduling API, letting you manage posts from Claude Code, Claude Desktop, OpenAI Codex CLI, and Gemini CLI.

Quick start

npm install
npm run setup   # interactive wizard

The wizard will:

1. Ask for your Publer API token and validate it live
2. Build the server (tsc)
3. Let you pick which agents to configure
4. Write the correct config file for each agent

Getting your Publer API token

1. Log in at https://publer.com/paweltkaczyk
2. Profile → Settings → API
3. Click Generate Token and copy the value

Manual installation

If you prefer to configure agents by hand, build first:

npm run build

Then add the following snippet to each agent's config file, replacing the values:

{
  "mcpServers": {
    "publer": {
      "command": "node",
      "args": ["/absolute/path/to/publer-mcp/dist/index.js"],
      "env": {
        "PUBLER_API_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Config file locations

Agent	Config file
Claude Code	~/.claude/settings.json
Claude Desktop (macOS)	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows)	%APPDATA%\Claude\claude_desktop_config.json
Claude Desktop (Linux)	~/.config/Claude/claude_desktop_config.json
OpenAI Codex CLI	~/.codex/config.json
Gemini CLI	~/.gemini/settings.json

Available tools

Tool	Description
get_current_user	Get the profile of the currently authenticated Publer user
list_workspaces	List all Publer workspaces the API token has access to
list_accounts	List all connected social media accounts in the current workspace
list_posts	List posts with optional filters (state, date range, etc.)
get_post	Retrieve a specific post by ID
update_post	Update an existing post's text, schedule, or media
schedule_post	Create a scheduled, draft, or recurring post across accounts
publish_post_now	Publish a post immediately across one or more accounts
delete_post	Delete a post by ID
get_post_insights	Get performance metrics for published posts
get_best_times	Get optimal posting times based on audience activity
list_media	List media assets in the workspace library
upload_media_file	Upload a local file to the media library
upload_media_from_url	Upload media from a public URL
get_job_status	Poll the status of an asynchronous job (e.g. post creation)
get_social_manager_instructions	Get high-level skill instructions and workflows
split_content_into_thread	Intelligently split long text for threads
validate_post	Check a post against platform constraints
manage_account_presets	List, create, or delete groups of accounts
schedule_posts_bulk	Schedule multiple posts in a single request
cleanup_media	Bulk delete media assets from the library

Advanced Features

• Account Presets: You can group multiple social media account IDs into a single label (e.g., @product). Once created via manage_account_presets, you can use @label in any account_ids field.
• Follow-up Comments: Tools like schedule_post and publish_post_now support a follow_up_text parameter. On platforms like X, Threads, and Mastodon, this automatically creates a thread. On Facebook and LinkedIn, it adds a comment.
• Social Manager Skill: This repository includes specialized agent instructions for handling platform-specific character limits, intelligent thread splitting, and optimal posting time selection.
  • Gemini CLI: Install as a native skill via npm run setup.
  • Claude Code: Setup automatically installs these as a native skill to .claude/skills/publer-social-manager/.
  • All Agents: Can access instructions by calling the get_social_manager_instructions tool.

Development

npm run dev      # run with tsx (no build step)
npm run build    # compile to dist/
npm run setup    # re-run the wizard (e.g. to rotate token or add agents)