OpenPost MCP

Install

Works in

• Claude Code
• Cursor
• Codex
• GitHub Copilot
• Gemini CLI
• VS Code
• OpenCode
• Claude Desktop
• SourceCraft
• Koda
• Coddy

npx skillfoxx add mcp/openpost-mcp

What it does

OpenPost MCP connects an agent to OpenPost, an open social publishing scheduler you can self-host or use in the hosted version. The agent sees workspaces, connected accounts, the media library, posts and their per-network variants, the schedule, provider readiness, comments and publication lifecycle events. With full access it creates and edits drafts and publications, queues them or sets a time, uploads media, replies to comments and moderates them. The server offers two endpoints. The main one, `https://app.openpo.st/mcp`, lists every operation as a separate tool, for example `list_workspaces`, `list_posts` or `create_post`. The compact one, `/mcp/code`, keeps a small set: `search_operations` finds operations and returns their schemas, `query_operation` runs read-only operations only, and `execute_operation` runs state-changing operations only. It suits clients with a strict tool list limit. For your own instance the address is replaced with your HTTPS address and the same /mcp path. If a client cannot reach your server, a local `openpost-mcp` bridge is installed: it reads the saved command-line profile and token and forwards messages to /mcp. The repository also has the `openpost` command line and an openpost-cli skill that teaches an agent to use it carefully: create a draft by default and publish, delete or disconnect an account only when asked.

Who it is for. For social media managers, marketers and owners of small brands who plan content in OpenPost and want agents in Claude Code, Cursor, Codex or ChatGPT to handle drafting, scheduling and reviewing posts.

Example request

Show this week's schedule in the personal workspace, find the publications that did not go out and prepare drafts for them without scheduling

MCP

Transport

http, stdio

Authentication

OAuth

Limitations

The project ships under the AGPL-3.0-only license. Sign-up in the hosted version temporarily goes through a waitlist while the owners finish approvals with social platforms, and existing accounts work as before.

Access is set by scope. The `mcp:read` scope only allows viewing. The `mcp:full` scope permits creating, editing, scheduling, publishing, uploading and moderating, and an OAuth request with no scope gets it by default, so choose `mcp:read` explicitly for reviews and audits. A token can be bound to one workspace.

A queued or scheduled post is not yet published. Some networks require provider app approval or publicly reachable media URLs. Cloud clients cannot see localhost or private addresses, so the local bridge fits only when the process runs on a machine that can reach the server. Clients cache tool definitions, so a new session is needed after switching the address or mode.

How to disable. In Claude Code run `claude mcp remove openpost -s user`; in other clients delete the openpost entry from the MCP settings. Revoke the developer token in OpenPost under Settings, Personal, Developer. The command line is removed with `npm uninstall -g @getopenpost/cli`.

README in short

The project is presented as an open replacement for Buffer, Canva and CapCut: a scheduler with a calendar and queues, an image and carousel editor, a video editor, a media library, a meme maker, an inbox, analytics and workflows that turn GitHub releases and RSS feeds into drafts. A separate section gathers the API, SDK, command line, MCP and n8n. It continues with self-hosting in one container with SQLite and local storage, the list of supported networks and contribution rules. Detailed docs for connecting each assistant are in the apps/docs folder.