Skip to content
postbasehqPublic

About

Open-source social media scheduler with an MCP server: post to X, LinkedIn, Bluesky, Mastodon, TikTok and YouTube, or let your AI do it.

Topics

Resources

Stars

11 stars

Watchers

0 watching

Forks

Latest commit

 

History

449 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Postbase

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/mcp npm 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.

About

Open-source social media scheduler with an MCP server: post to X, LinkedIn, Bluesky, Mastodon, TikTok and YouTube, or let your AI do it.

Topics

Resources

Stars

11 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages