Description
🆕 NEW: meet the PostQueen Agent, run your social media from Claude Code, ChatGPT, OpenClaw or Hermes »
Stop doing social media yourself.
PostQueen is an AI employee for your social media. Tell her what to share, in one sentence. She writes the copy, designs the visual and schedules it on every channel you have. You just review the calendar.
PostQueen is the open-source alternative to Buffer, Hootsuite, Sprout Social and Later.
Website ·
Pricing ·
Docs ·
API Reference ·
Agents ·
MCP ·
CLI
Schedule and generate posts with AI
Free for 7 days in the cloud. Forever free on your own server.
—
🔁 What you can build
Here are nine things you can run with this node, from a simple cross-poster to a channel that grows itself overnight. Every PostQueen step below is a real operation of the node, and any n8n trigger, whether a schedule, an RSS feed, a webhook or a form, can start them.
🌐 One post, every channel
You (or any n8n node) write the content and PostQueen does the publishing. An AI draft, an RSS item or a row from a sheet goes into one Create Post, and it comes out scheduled on every channel you have.
📰 Blog on autopilot
An RSS trigger watches your blog, an AI node writes the caption for each new article, and Create Post schedules it to every channel at once. Publish the article and walk away; the promotion handles itself.
🎬 Grow a YouTube channel while you sleep
This is the one people set up and forget. A daily Schedule Trigger runs Generate Video with your prompt, as veo3 or image-text-slides, vertical or horizontal, with a voiceover if you want one (list the voices with Video Function → loadVoices). Then Create Post queues the finished video to your channel: a new upload every morning, whether you opened your laptop or not. Video generation is an operation even the postqueen CLI does not have; this node is the only no-code way to drive it.
📱 One clip → TikTok, Reels and Shorts
Drop a new video into Drive, Dropbox or S3 and the rest happens on its own: Upload File brings the clip in, and one Create Post schedules it to TikTok, Instagram and YouTube together, since the posts array takes as many channels as you like. Upload first and pass the returned path into the post; TikTok, Instagram and YouTube only accept media from trusted domains.
🚀 Launch-day announcement blast
A form submission or a new product row in a sheet kicks off the announcement: Get Channels finds your accounts and Create Post tells all of them at once. Ask for a draft instead if you want a human to sign off first.
📝 Drafts with human sign-off
A form submission (or any trigger) runs Create Post with type draft, and a Slack message asks the team to review. Once someone approves it on the calendar, PostQueen takes it from there.
♻️ Evergreen recycler
Every Friday, Get Posts pulls your archive, an AI node picks the winners, and Create Post re-queues the evergreen ones. Your ten best posts can keep introducing you to new followers for months.
🗞️ Sunday digest
Every Sunday, an AI node writes the week’s roundup and Create Post sends it to every channel. Your audience gets a dependable weekly ritual, and you never have to write it.
🛡️ Queue guard
Every Monday, Get Posts pulls the next seven days of your calendar; if the queue looks empty, a Slack message tells you before your followers notice.
📦 Installation
n8n UI (recommended)
1. Open Settings → Community Nodes.
2. Click Install.
3. Enter n8n-nodes-postqueen as the npm package name.
4. Click Install.
!n8n Community Nodes install modal with n8n-nodes-postqueen entered as the npm package name
npm (manual, non-Docker)
Go to your n8n installation folder (usually ~/.n8n). If there is no custom folder, create one with a package.json, then install the package:
mkdir -p ~/.n8n/custom
cd ~/.n8n/custom
npm init -y
npm install n8n-nodes-postqueen
Docker
Create a folder on your host machine for custom nodes and install the package there:
mkdir -p ~/n8n-custom-nodes
cd ~/n8n-custom-nodes
npm init -y
npm install n8n-nodes-postqueen
Then mount that folder into the container (host path to /home/node/n8n-custom-nodes) and point n8n at it:
docker run -d --name n8n
-v ~/n8n-custom-nodes:/home/node/n8n-custom-nodes
-e N8NCUSTOMEXTENSIONS="/home/node/n8n-custom-nodes"
-p 5678:5678 n8nio/n8n
Requires n8n running on Node.js >=20.15.
🔑 Credentials
The node authenticates with a PostQueen API credential that has two fields:
| Field | Description |
| — | — |
| API Key | Your PostQueen Public API key. Grab it at app.postqueen.ai/settings (Developers → Public API → Reveal). |
| Host | Base URL of the PostQueen API. Defaults to https://api.postqueen.ai (cloud). |
To add the credential in n8n, create a new PostQueen API credential, paste your API key, and (if self-hosting) set the host. n8n validates it against a live test endpoint when you save.
> Self-hosting note: point Host at your own instance’s API base URL. It must end with /api, for example https://yourdomain.com/api.
⚙️ Operations
The PostQueen node exposes 7 operations:
| Operation | Description |
| — | — |
| Create Post | Schedule, draft, or immediately publish a post to one or more channels. |
| Delete Post | Delete a post by its ID. |
| Generate Video | Generate a video with AI (see parameters below). |
| Get Channels | List your connected channels (integrations). |
| Get Posts | List posts within a start/end date range, optionally filtered by customer. |
| Upload File | Upload a file (image or video) from a binary property. |
| Video Function | Run a video helper function, such as loading available voices. |
Generate Video takes a Video Type (for example image-text-slides or veo3), an Output Format (vertical or horizontal), and optional Custom Parameters (key/value pairs such as prompt, voice, or images).
🤝 Works with the rest of the platform
The node talks to the same public API as the CLI, the SDK and the MCP server, so whatever you automate here plays nicely with whatever your AI assistant does through postqueen-agent. The full API is browsable in the Swagger reference and explained in the public API docs. Make.com and Zapier can call the same API directly, no node required.
⚙️ How she works
flowchart TD
A["🧑 You
(or your AI assistant)"] -->|MCP · CLI · API · n8n| B["👑 PostQueen"]
B --> C["📅 Your calendar
review · edit · approve drafts"]
C --> D["⏰ Temporal scheduler
publishes on time, retries on failure"]
D --> E["🌐 30+ networks"]
1. You say it once, from the app, a chat or your terminal.
2. She does the work: research, copy shaped to each platform, and an image or video to match.
3. The calendar is yours: let it run on autopilot, edit anything before it goes out, or ask for drafts and approve each post yourself.
4. It goes out on time, every time. A Temporal workflow engine fires each post exactly when planned, retries on failure, and quietly refreshes your platform tokens in the background.
Curious about the internals? Read how it works in the docs.
—
🌙 An agent that works while you sleep
She does not clock out when you do. Agents like Hermes and OpenClaw can run on a schedule, not just on demand: a small recurring job wakes up before you, checks yesterday’s numbers with analytics:platform, and has today’s post drafted while your coffee is still brewing. Each of those steps is a CLI command or an MCP call with JSON output, so any agent that can run a command can hold down the night shift.
Gemini CLI, Aider and your own cron scripts qualify too. Start from the Agent guide or the MCP guide, and find the full command reference in postqueen-agent.
—
🦞 Meet her open agents: OpenClaw & Hermes
Two open-source agents already speak PostQueen natively. OpenClaw lives on your machine and turns any chat app into her front door. Hermes does the same, then goes further: hand it a single brief and it plans, writes and schedules your entire week on its own. Both drive the same postqueen CLI, so everything they do shows up on your calendar.
Any other agent works too. If it can run a CLI command or call MCP, it can run your socials. Agent guide »
—
🚀 Get started in minutes
☁️ Cloud, the fast lane
Skip the setup entirely: create an account, connect your channels, and your first post can go out today. The 7-day trial is free, and there is nothing to install or maintain.
🐳 Self-host, the free lane
Some people love running their own tools, and she is happy to move in. The whole stack comes up on your machine with Docker in a few minutes, and it stays free forever, every connector and every feature included:
git clone https://github.com/GkhanKINAY/postqueen-docker-compose
cd postqueen-docker-compose
set a unique JWT_SECRET and your public URLs in docker-compose.yaml
docker compose up -d # then open http://localhost:4007
You will need Docker and about 4 GB of RAM. To connect real social accounts you will also need a public HTTPS domain behind a reverse proxy: the networks send their OAuth callbacks there. The stack ships the app and its backing services: PostgreSQL, Redis and Temporal.
Full walkthrough: self-host guide · Kubernetes: postqueen-helmchart · every setting: configuration reference
—
🌐 Publish everywhere
One post from you, and she is everywhere at once. PostQueen publishes to 30+ networks out of the box:
| Category | Networks |
| — | — |
| Major social | X, LinkedIn, Instagram, Facebook, TikTok, YouTube, Threads, Pinterest, Reddit, Bluesky |
| Community and chat | Discord, Slack, Telegram, Mastodon, Twitch, Kick, MeWe, VK |
| Publishing and blogs | WordPress, Medium, Dev.to, Hashnode, Tumblr, Listmonk, Moltbook |
| Web3 and decentralized | Nostr, Farcaster, Lemmy |
| Creator and business | Google Business Profile, Whop, Skool, Dribbble |
LinkedIn and Instagram each support both personal and page posting. New connectors ship regularly: see the full list with per-network guides at postqueen.ai/channels.
—
🛡️ Compliance
- PostQueen is an open-source, self-hostable social media scheduler that supports X, LinkedIn, Instagram, Bluesky, Mastodon, Discord and 30+ more.
- The hosted service uses official, platform-approved OAuth flows.
- PostQueen does not automate or scrape content from social media platforms.
- PostQueen does not collect, store, or proxy API keys or access tokens from users.
- PostQueen never asks users to paste social-platform credentials into the hosted product.
- Users always authenticate directly with each platform (X, LinkedIn, Discord, and so on), which keeps every platform’s compliance and your data privacy intact.
- 🐛 Found a bug or have an idea? Open an issue.
- 💌 Need a hand? Email support@postqueen.ai.
- 📚 Getting started? The docs walk you through everything.
- 🤝 Want to contribute? Start with the contribution guide; security reports go to SECURITY.md.
—
❤️ Community and support
If PostQueen saves you time, a ⭐ on the repo genuinely helps other people find it.
—
🙏 Thank you, Postiz
PostQueen is a fork of Postiz by Nevo David, released under AGPL-3.0. Postiz gave us a rock-solid open-source scheduler: the connectors, the calendar, the Temporal pipeline, years of careful work that we did not have to redo. We forked it because we wanted to take that foundation in a specific direction, a social media manager you talk to instead of operate, and building on Postiz let us start from something that already worked.
Thank you, Nevo David and every Postiz contributor. This project exists because you chose to open-source yours. If PostQueen is not quite what you need, Postiz itself might be, and it deserves your star too. 🙏
—
👑 The PostQueen ecosystem
| Repository | What lives there |
| — | — |
| postqueen-app | The application itself: frontend, backend, workers |
| postqueen-agent | Agent CLI and skill: give any AI assistant hands |
| postqueen-docker-compose | Self-host the whole stack with one command |
| postqueen-helmchart | Run it on Kubernetes |
| postqueen-n8n | The n8n community node for no-code automation |
| postqueen-docs | Source of docs.postqueen.ai |
On npm: postqueen (CLI) · @postqueen/node (SDK) · n8n-nodes-postqueen (n8n)
Long live the queen. 👑
License
This node package is released under the MIT license.
This node is a fork of the Postiz community node. Thanks to Nevo David and the Postiz contributors for the foundation this builds on.
