Postbase MCP server
Commit Nov 11, 2026Allows AI clients to draft, schedule, and manage social media posts across platforms like X, LinkedIn, Bluesky, Mastodon, TikTok, and YouTube.
Also known as postbasehq/postbase
- Stars
- 26
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 11, 2026
- License
- AGPL-3.0
What is Postbase MCP?
Postbase allows AI clients to draft, schedule, and manage social media posts across platforms like X, LinkedIn, Bluesky, Mastodon, TikTok, and YouTube.
Summary generated from the project's README
About Postbase MCP server
Managing social media presence across multiple platforms from within your AI development environment is what Postbase enables. Developers and content creators can use this MCP server to draft, schedule, and manage posts for X, LinkedIn, Bluesky, Mastodon, TikTok, and YouTube. It functions as an MCP-native scheduler that integrates directly with clients like Claude, ChatGPT, Cursor, and Claude Code.
Users can connect to the service using the hosted server via OAuth sign-in or by installing the @postbasehq/mcp npm package with an API key. The server provides specific tools including list_channels, create_post, list_scheduled, and cancel_post to give AI agents direct control over your social calendar. You can choose to use the hosted cloud version or self-host the application using the provided codebase and Supabase configuration.
What you can do with it
- 1Drafting and scheduling social contentAsk your AI agent to write a new post and schedule it for a specific time on your connected social channels.
- 2Reviewing upcoming social media postsRequest a list of all posts that are currently queued to be published.
- 3Canceling scheduled social media updatesInstruct your AI client to stop a post that has already been scheduled but not yet published.
- 4Checking connected social media accountsHave your AI agent identify which social media platforms are currently linked to your account.
Written from the project's README. Every use case is checked against a quote from it.
README
View on GitHubPostbase
The social scheduler even your AI can run.
Postbase is an open-source, MCP-native social media scheduler. Connect your channels, compose and schedule posts, and Postbase publishes them across every channel on time — from a clean dashboard, or straight from the AI tools you already work in.
- MCP-native — Claude, ChatGPT, Cursor, Claude Code and other MCP clients can
draft and schedule posts through the hosted server at
https://mcp.postbase.so/mcp(OAuth sign-in) or the@postbasehq/mcpnpm package (API key). There's a REST API too. - Built-in AI agent — a chat in the app that drafts posts and schedules them once you confirm.
- Self-host free, or use the hosted cloud — same product either way.
Channels: X, LinkedIn, Bluesky, Mastodon, TikTok, YouTube · Instagram, Facebook and Threads coming soon.
Docs: docs.postbase.so
Tech stack
- Next.js (App Router) + TypeScript + Tailwind
- Supabase — Postgres, Auth, Storage
- Vercel Cron — scheduled-publishing poller
@postbasehq/mcp— MCP server (npm)
Getting started
npm install
cp .env.example .env.local # fill in your Supabase (and later, platform) keys
npm run dev
Apply the database schema in supabase/migrations/ (via the Supabase SQL editor
or the CLI). To run the scheduled publisher locally (polls the publish endpoint):
npm run poll # in a second terminal
In production, a Vercel Cron job hits /api/cron/publish every minute
(vercel.json), so no separate worker is needed.
MCP server
Add Postbase to your AI client and let an agent schedule posts for you. The MCP
server lives in its own repo: postbasehq/mcp
(published as @postbasehq/mcp on
npm). Tools: list_channels, create_post, list_scheduled, cancel_post.
Project layout
app/ Next.js routes (marketing, dashboard, /api, /api/v1)
components/ UI components
lib/ Supabase clients, publishing adapters, plans/billing, API core
supabase/ SQL migrations
legal/ Privacy Policy & Terms (source for /privacy and /terms)
The MCP server is maintained separately at postbasehq/mcp.
License
AGPL-3.0-or-later.
Postbase MCP questions
Which social media channels can I post to?
You can post to X, LinkedIn, Bluesky, Mastodon, TikTok, and YouTube, with Instagram, Facebook, and Threads coming soon.
What tools are available through the MCP server?
The MCP server provides tools to list channels, create posts, list scheduled posts, and cancel posts.