Postbase

io.github.postbasehqv0.1.1Updated Oct 6, 2026

Schedule social posts and threads to X, LinkedIn, Bluesky and Mastodon from your AI.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowCommunication & Collaboration

Overview

AI-generated overview

Lets an assistant draft and schedule social posts and threads to X, LinkedIn, Bluesky and Mastodon through Postbase.

What it does
Connects an assistant to Postbase, an open-source social media scheduler. Tools include list_channels to see connected accounts, create_post to make a post or draft with an optional scheduled time, schedule_thread for X threads, list_scheduled to view queued posts, and cancel_post to cancel one by id. TikTok and YouTube are not covered because they need video.
When to use it
Useful when you want an assistant to draft, queue or cancel social posts and X threads across several networks without opening the scheduler. Best if you already use Postbase or are willing to run or sign in to it.
Requirements
Either the hosted remote endpoint with OAuth sign-in, or the npm package @postbasehq/mcp run locally with Node.js via npx. The local package needs an API key in POSTBASE_API_KEY, created in the Postbase dashboard under Developers. POSTBASE_API_URL is optional and points at a self-hosted instance. Network access to Postbase is required.
Before you install
The local package requires the secret POSTBASE_API_KEY, which grants access to your Postbase workspace. Tools can create, schedule and cancel posts, so an assistant can publish or remove content on connected accounts; review drafts before scheduling. The hosted option uses OAuth sign-in instead of an API key.

Installation

In SourceWeft

  1. Open Postbase in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "postbase": {
      "type": "http",
      "url": "https://mcp.postbase.so/mcp"
    }
  }
}

README

@postbasehq/mcp

[CI] [npm version] [npm downloads] [license] [Node]

The Model Context Protocol server for Postbase, the open-source social media scheduler. Add it to Claude, Cursor or any MCP client and let your AI agent draft and schedule posts and threads to X, LinkedIn, Bluesky and Mastodon. (TikTok and YouTube need a video, so schedule those in the app.)

Post everywhere. Even from your AI.

Hosted server (no API key)

Postbase also runs this server for you at https://mcp.postbase.so/mcp, with OAuth sign-in instead of an API key. Add that URL as a custom connector in Claude or ChatGPT, or as a remote MCP server in Cursor, VS Code, Windsurf, Claude Code or Gemini CLI. The MCP config generator prints the exact setup for each one.

Use this npm package when you want an API key instead, or a self-hosted Postbase.

Quick start

  1. Create an API key in your Postbase dashboard under Developers.
  2. Add the server to your MCP client config (see examples below).
  3. Ask your agent: "Schedule this thread for 9am to X and Bluesky."

Example configs

Any MCP client — the minimal config:

json
{  "mcpServers": {    "postbase": {      "command": "npx",      "args": ["@postbasehq/mcp"],      "env": { "POSTBASE_API_KEY": "pb_live_your_key_here" }    }  }}

Claude Desktop — add the same block to your config file:

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

Then restart Claude Desktop.

Cursor — add it to ~/.cursor/mcp.json (or Settings → MCP):

json
{  "mcpServers": {    "postbase": {      "command": "npx",      "args": ["@postbasehq/mcp"],      "env": { "POSTBASE_API_KEY": "pb_live_your_key_here" }    }  }}

Local development — point at a Postbase instance running on your machine:

json
{  "mcpServers": {    "postbase": {      "command": "npx",      "args": ["@postbasehq/mcp"],      "env": {        "POSTBASE_API_KEY": "pb_live_your_key_here",        "POSTBASE_API_URL": "http://localhost:3000/api/v1"      }    }  }}

Tools

ToolWhat it does
list_channelsList the channels connected to your workspace.
create_postCreate a post — body, channel_ids, optional ISO scheduled_at (omit for a draft).
schedule_threadCreate an X thread (tweets in order) and optionally schedule it.
list_scheduledList posts scheduled to publish.
cancel_postCancel a scheduled post by id.

Environment

VariableRequiredDefault
POSTBASE_API_KEYyes—
POSTBASE_API_URLnohttps://www.postbase.so/api/v1

For local development against a Postbase instance on your machine, set POSTBASE_API_URL=http://localhost:3000/api/v1.

License

AGPL-3.0-or-later. Part of the open-source Postbase project.

Source: README.md at commit d29bdcb

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.1.1LatestOct 6, 2026