# Postbase

Lets your coding agent queue posts and threads for X, LinkedIn, Bluesky and Mastodon through Postbase, without opening the scheduler.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: postbasehq
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/postbasehq/mcp
- Updated: 2026-10-10
- HTML: https://affpapa.org/en/nevibecode/mcp/postbase

## What it does

Postbase is an open-source social scheduler, and this server hands its API to your agent. The agent can save drafts or queue single posts and threads for X, LinkedIn, Bluesky and Mastodon. Timing goes in as `scheduled_at` (ISO 8601 with an offset) or `schedule_in_minutes`, and `channel_bodies` gives each network its own wording.

Other tools cover the rest of the loop. `get_post` reports status and live URL per channel, `retry_post` resends where delivery failed, and `get_analytics` returns impressions, likes, comments, shares and saves. An `idempotency_key` keeps a retried call from publishing twice. Media comes from your library by id, or from a public https link through `add_media`.

There are two ways in. The hosted endpoint `https://mcp.postbase.so/mcp` signs you in with OAuth. The npm package `@postbasehq/mcp` requires a `POSTBASE_API_KEY` from the Developers section of your dashboard. TikTok posts made through `create_post` stay drafts, so publish those in the app.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.postbase.so/mcp`
- Environment variables: `POSTBASE_API_KEY`, `POSTBASE_API_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http postbase https://mcp.postbase.so/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env POSTBASE_API_KEY=<POSTBASE_API_KEY> --env POSTBASE_API_URL=<POSTBASE_API_URL> --transport stdio postbase -- npx -y @postbasehq/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add postbase --url https://mcp.postbase.so/mcp
```

2. **Platform CLI**
```bash
codex mcp add postbase --env POSTBASE_API_KEY=<POSTBASE_API_KEY> --env POSTBASE_API_URL=<POSTBASE_API_URL> -- npx -y @postbasehq/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "postbase": {
            "url": "https://mcp.postbase.so/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "postbase": {
            "command": "npx",
            "args": [
                "-y",
                "@postbasehq/mcp"
            ],
            "env": {
                "POSTBASE_API_KEY": "<POSTBASE_API_KEY>",
                "POSTBASE_API_URL": "<POSTBASE_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "postbase": {
            "type": "http",
            "url": "https://mcp.postbase.so/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "postbase": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@postbasehq/mcp"
            ],
            "env": {
                "POSTBASE_API_KEY": "<POSTBASE_API_KEY>",
                "POSTBASE_API_URL": "<POSTBASE_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http postbase https://mcp.postbase.so/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e POSTBASE_API_KEY=<POSTBASE_API_KEY> -e POSTBASE_API_URL=<POSTBASE_API_URL> postbase npx -y @postbasehq/mcp
```
Replace <…> with your own values

## When to use it
- schedule a thread for a set time on several networks at once
- write separate copy for each channel in one request
- attach an image or video from the media library to a post
- find which channels a post missed and resend it
- compare impressions and likes across posts

## Example prompts
- Use Postbase to schedule this thread on X and Bluesky for tomorrow morning
- List my scheduled posts in Postbase and cancel the latest one
- Pull Postbase analytics for yesterday's post and retry it on the channels where it failed

## Similar
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107423
- [openshorts](https://affpapa.org/en/nevibecode/mcp/openshorts.md) — MCP server · ★ 7049
- [OpenScreen](https://affpapa.org/en/nevibecode/mcp/openscreen.md) — MCP server · ★ 4863
- [Usertour MCP Server](https://affpapa.org/en/nevibecode/mcp/usertour-mcp-server.md) — MCP server · ★ 2326
- [Appllama](https://affpapa.org/en/nevibecode/mcp/appllama.md) — MCP server · ★ 3046
- [obsei](https://affpapa.org/en/nevibecode/mcp/obsei.md) — MCP server · ★ 1441

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md