lumizone/postsider

Open-source social media scheduling for humans, teams, and AI agents.
Schedule and publish across 33 built-in connectors from one calendar.
Self-host with Docker, automate through the REST API and Node.js SDK, or connect AI agents through MCP.
Website
Documentation
Quick Start
MCP
API & SDK
## What is PostSider?
PostSider is an open-source social media management and scheduling platform built around four ways of working:
| Use PostSider as | What you get |
| Social media scheduler | One calendar for planning, composing, approving, scheduling, and publishing content |
| Self-hosted platform | A Docker-based deployment you can run on your own infrastructure |
| Automation backend | A public REST API plus the @postsider/node SDK |
| AI-agent bridge | An MCP server that lets compatible agents work with PostSider through structured tools |
PostSider ships with 33 active connectors registered in the application. You configure credentials only for the platforms you actually use.
AI features are optional. PostSider works without an OpenAI API key.
## Quick Start
For a local evaluation, the fastest path is Docker Compose.
### Requirements
Docker
Docker Compose
### Start PostSider
bash
git clone https://github.com/lumizone/postsider.git
cd postsider
docker compose up -d
The default Compose stack pulls:
text
ghcr.io/lumizone/postsider-app:latest
and starts PostSider with PostgreSQL, Redis, and Temporal.
Open:
text
http://localhost:4007
Create the first administrator account:
bash
docker exec -it postsider pnpm bootstrap
The bootstrap command prints a one-time password. Sign in with:
text
admin@setup.local
and the generated password. PostSider then prompts you to set your real email address and password.
> The root docker-compose.yaml is convenient for local evaluation. For an internet-facing deployment, use the production setup and the self-hosting guide.
## Highlights
### Scheduling and publishing
Visual calendar with drag-and-drop scheduling
Posting queue and find-free-slot scheduling
Smart Slot suggestions
Evergreen content recycling
Per-platform previews
Per-platform validation before publishing
Automatic first comments where supported
Bulk CSV import
### Content workflow
Hashtag groups
Caption templates
Reusable snippets
UTM builder
Draft and approval workflows
Shared media library
### Teams and organizations
Multi-organization workspaces
Separate workspaces for brands or clients
Admin and User roles
Shared publishing workflow
### Automation
Public REST API
Node.js SDK: @postsider/node
MCP server: @postsider/mcp
Webhooks
Programmatic scheduling and channel access
### Optional AI
Post Checker
Caption rewriting
Platform-level OPENAIAPIKEY
Per-organization bring-your-own key support
### Security
Optional TOTP two-factor authentication
One-time recovery codes
Organization-wide 2FA enforcement
Encrypted provider credentials at rest
Security activity trail
Secure httpOnly cookies
CORS and CSP controls
Rate limiting
Server-side authorization and plan enforcement
## Supported Platforms
The list below mirrors the active providers registered in:
libraries/nestjs-libraries/src/integrations/integration.manager.ts
| Category | Platforms |
| Social & creator platforms | X, LinkedIn Profile, LinkedIn Page, Facebook, Instagram via Facebook, Instagram Standalone, Threads, YouTube, TikTok, Pinterest, Bluesky, Mastodon, Nostr, Farcaster, Lemmy, Twitch, Dribbble, Google Business Profile, Whop, Moltbook |