Draft and schedule social media posts, threads, and videos to X, LinkedIn, Bluesky, Mastodon, and YouTube using an AI agent.
Also known as postbasehq/mcp, mcp, @postbasehq/mcp
- Stars
- 10
- Tools
- 11
- Downloads, 30 days
- —
- Latest version
- 0.3.0
- Last commit
- Oct 10, 2026
- License
- AGPL-3.0
What is Postbase MCP?
Postbase is an MCP server. Draft and schedule social media posts, threads, and videos to X, LinkedIn, Bluesky, Mastodon, and YouTube using an AI agent. It exposes 11 tools, such as list_channels, create_post, get_post.
Summary generated from the project's README
About Postbase MCP server
Postbase allows developers to manage social media presence through an AI agent. By connecting this server to clients like Claude, Cursor, or Windsurf, you can draft and schedule content across X, LinkedIn, Bluesky, and Mastodon. While the server handles text and threads, video content for platforms like TikTok and YouTube requires manual scheduling within the Postbase application.
You can deploy this as a local server using the npm package with a POSTBASE_API_KEY, or use the hosted version at mcp.postbase.so which utilizes OAuth sign-in. The server provides specific tools to manage your workflow, including create_post for scheduling, get_analytics to track impressions and likes, and list_media to access your library. It also supports updating existing drafts, retrying failed posts, and canceling scheduled content.
What you can do with it
- 1Schedule social media threadsAsk your AI agent to prepare and time a series of connected posts for specific platforms.
- 2Monitor post performanceRetrieve engagement data such as likes, comments, and shares for your published content.
- 3Manage media assetsAdd new images or videos to your library from a public URL to use in future posts.
- 4Handle failed deliveriesInstruct your agent to attempt to resend posts that did not successfully publish to their intended channels.
Written from the project's README. Every use case is checked against a quote from it.
How to install Postbase MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Postbase MCP in Claude Code
$ claude mcp add --env 'POSTBASE_API_KEY=<YOUR_POSTBASE_API_KEY>' mcp -- npx -y @postbasehq/mcpInstall Postbase MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postbasehq/mcp"
],
"env": {
"POSTBASE_API_KEY": "<YOUR_POSTBASE_API_KEY>"
}
}
}
}Install Postbase MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@postbasehq/mcp"
],
"env": {
"POSTBASE_API_KEY": "<YOUR_POSTBASE_API_KEY>"
}
}
}
}Install Postbase MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@postbasehq/mcp"],"env":{"POSTBASE_API_KEY":"<YOUR_POSTBASE_API_KEY>"}}'Install Postbase MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postbasehq/mcp"
],
"env": {
"POSTBASE_API_KEY": "<YOUR_POSTBASE_API_KEY>"
}
}
}
}Install Postbase MCP in Codex
$ codex mcp add mcp --env 'POSTBASE_API_KEY=<YOUR_POSTBASE_API_KEY>' -- npx -y @postbasehq/mcpInstall Postbase MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@postbasehq/mcp"] [mcp_servers.mcp.env] POSTBASE_API_KEY = "<YOUR_POSTBASE_API_KEY>"
Install Postbase MCP in Gemini CLI
$ gemini mcp add -s user -e 'POSTBASE_API_KEY=<YOUR_POSTBASE_API_KEY>' mcp npx -- -y @postbasehq/mcpInstall Postbase MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postbasehq/mcp"
],
"env": {
"POSTBASE_API_KEY": "<YOUR_POSTBASE_API_KEY>"
}
}
}
}Needs a key before it starts
Started on 16 Nov 2026 with no keys, it stopped and asked for one, so a client sees no tools until you set the variables above.
Postbase MCP tools 11
Detected from the READMElist_channelscreate_postget_postupdate_postretry_postget_analyticslist_mediaadd_medialist_scheduledcancel_postschedule_thread
Configuration
POSTBASE_API_KEYRequiredSecretAPI key from Postbase → Developers
POSTBASE_API_URLAPI base URL, for self-hosted instances (default https://www.postbase.so/api/v1)
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHub@postbasehq/mcp
The Model Context Protocol server for Postbase, the open-source social media scheduler. Add it to Claude, Cursor or any MCP client and let your AI agent draft and schedule posts and threads to X, LinkedIn, Bluesky and Mastodon. (TikTok and YouTube need a video, so schedule those in the app.)
Post everywhere. Even from your AI.
Hosted server (no API key)
Postbase also runs this server for you at https://mcp.postbase.so/mcp, with
OAuth sign-in instead of an API key. Add that URL as a custom connector in Claude
or ChatGPT, or as a remote MCP server in Cursor, VS Code, Windsurf, Claude Code or
Gemini CLI. The MCP config generator
prints the exact setup for each one.
Use this npm package when you want an API key instead, or a self-hosted Postbase.
Quick start
- Create an API key in your Postbase dashboard under Developers.
- Add the server to your MCP client config (see examples below).
- Ask your agent: "Schedule this thread for 9am to X and Bluesky."
Example configs
Any MCP client — the minimal config:
{
"mcpServers": {
"postbase": {
"command": "npx",
"args": ["@postbasehq/mcp"],
"env": { "POSTBASE_API_KEY": "pb_live_your_key_here" }
}
}
}
Claude Desktop — add the same block to your config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Then restart Claude Desktop.
Cursor — add it to ~/.cursor/mcp.json (or Settings → MCP):
{
"mcpServers": {
"postbase": {
"command": "npx",
"args": ["@postbasehq/mcp"],
"env": { "POSTBASE_API_KEY": "pb_live_your_key_here" }
}
}
}
Local development — point at a Postbase instance running on your machine:
{
"mcpServers": {
"postbase": {
"command": "npx",
"args": ["@postbasehq/mcp"],
"env": {
"POSTBASE_API_KEY": "pb_live_your_key_here",
"POSTBASE_API_URL": "http://localhost:3000/api/v1"
}
}
}
}
Tools
| Tool | What it does |
|---|---|
list_channels |
List the channels connected to your workspace. |
create_post |
Create a draft, or schedule a post or thread: channel_ids, scheduled_at (ISO 8601 with an offset) or schedule_in_minutes, channel_bodies for per-channel text, media_ids or media_urls, youtube details, and an idempotency_key so retries can't post twice. TikTok posts can only be drafts. |
get_post |
How a post went on each channel: status, live URL, error, retry time and latest metrics. |
update_post |
Edit or reschedule a draft or scheduled post; only the fields you pass change. |
retry_post |
Send a post again to the channels where it failed. |
get_analytics |
Impressions, likes, comments, shares and saves per post and channel, with totals. |
list_media |
List images and videos in your Postbase media library, to attach by id. |
add_media |
Add an image or video to the media library from a public https link. |
list_scheduled |
List scheduled posts, or drafts, published or failed ones with status. |
cancel_post |
Cancel a scheduled post by id (it goes back to a draft). |
schedule_thread |
Create a thread (tweets in order). Kept for older setups; create_post with thread does the same. |
Environment
| Variable | Required | Default |
|---|---|---|
POSTBASE_API_KEY |
yes | — |
POSTBASE_API_URL |
no | https://www.postbase.so/api/v1 |
For local development against a Postbase instance on your machine, set
POSTBASE_API_URL=http://localhost:3000/api/v1.
License
AGPL-3.0-or-later. Part of the open-source Postbase project.
Postbase MCP questions
How do I add Postbase MCP to Claude Code?
Run claude mcp add --env 'POSTBASE_API_KEY=<YOUR_POSTBASE_API_KEY>' mcp -- npx -y @postbasehq/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Postbase MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Postbase MCP provide?
It exposes 11 tools, including list_channels, create_post, get_post, update_post, retry_post.
Which social media platforms can I post to?
You can draft and schedule posts and threads to X, LinkedIn, Bluesky, and Mastodon. YouTube and TikTok require specific handling.
Do I need an API key to use the hosted server?
No, the hosted server at mcp.postbase.so uses OAuth sign-in instead of an API key.
How do I schedule a thread?
You can use the schedule_thread tool or the create_post tool with the thread parameter to create a sequence of posts.
Can I use this with a self-hosted Postbase instance?
Yes, you can use the npm package and point it to your local instance by setting the POSTBASE_API_URL environment variable.