AstaBlackClove/posthive
📇 🏠 - Schedule and manage social media posts across 13 platforms (Bluesky, Threads, Instagram, LinkedIn, Mastodon, YouTube, Facebook, Pinterest, Telegram, Nostr, X/Twitter, Discord, Tumblr). OAuth 2.0 + PKCE, 10 tools, draft-first workflow.
Quick Install
{
"mcpServers": {
"astablackclove-posthive": {
"command": "npx",
"args": [
"-y",
"astablackclove-posthive"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
Posthive
The agentic social media scheduling platform with built-in AI agent support.
Schedule posts across platforms from one place self-hostable, no vendor lock-in.
📖 Docs · 🤖 AI Agent Setup · 💬 Discord · 🌐 Website
Features
- Multi-platform posting - write once, publish to 14+ platforms simultaneously
- AI agent support - connect Claude, ChatGPT, Cursor, VS Code via MCP; OAuth 2.0 + PKCE, no API key to paste
- Calendar view - FullCalendar month/week/day with drag-to-reschedule
- Bulk CSV scheduling - upload a spreadsheet to schedule hundreds of posts at once
- Post templates - save and reuse post drafts
- First comment scheduling - auto-reply immediately after the post goes live
- Per-platform overrides - custom text and first comment per account
- Instagram Reels & Stories - full media type support including carousels
- YouTube Shorts & videos - dedicated title/description fields, custom thumbnail upload
- Dry run mode - test the full pipeline without real API calls
- Draft posts - save compose state, schedule later
- Public REST API - full CRUD with Bearer auth (Pro/Team)
- Self-hostable - Docker compose, one command, billing optional
Tech Stack
| Layer | Technology |
|---|---|
| Frontend | Next.js 16 (App Router), React 18, Tailwind CSS |
| Backend | Fastify v4, TypeScript ESM, Node.js |
| Database | Prisma 5 + Postgres |
| Queue | BullMQ + Redis (Upstash / Railway) |
| Storage | Local disk (dev) / Supabase Storage (prod) |
| Resend | |
| Billing | Dodo Payments (optional) |
| Monitoring | Sentry |
Quick Start (Self-hosting)
git clone https://github.com/AstaBlackClove/posthive.git
cd posthive
cp apps/api/.env.example .env
# Fill in ENCRYPTION_KEY, JWT secrets, DATABASE_URL, REDIS_URL
docker compose up -d --build
Open http://localhost:3000 and register. Billing is disabled by default all features unlocked.
Full setup guide → posthive.co/docs
Developer Setup
pnpm install
cp apps/api/.env.example apps/api/.env
pnpm dev # starts API + Web + Postgres (Docker)
| Service | URL |
|---|---|
| Web | http://localhost:3000 |
| API | http://localhost:3001 |
| Prisma Studio | http://localhost:5555 |
Environment variables & platform OAuth setup → posthive.co/docs
AI Agent Integration (MCP)
Connect any MCP-compatible AI agent to Posthive with a single URL no API key to generate or paste.
# Claude Code
claude mcp add --transport http posthive https://your-api/mcp
# Cursor / VS Code — add to mcp.json
{ "mcpServers": { "posthive": { "url": "https://your-api/mcp" } } }
The first tool call opens your browser to sign in. Full setup per client → posthive.co/agent
10 tools available: list_accounts · create_post · get_post · list_scheduled_posts · approve_draft · update_post · duplicate_post · delete_post · list_templates · create_from_template
Star History
Community
Questions, feature requests, bugs join the Discord:
License
AGPL-3.0 if you modify this project and run it as a network service, you must make your source available to users of that service.