Skip to main content

Use PostBoost with Gemini CLI

Connect Google's Gemini CLI to PostBoost's MCP server to schedule social media posts and manage accounts from the terminal.

note

PostBoost's MCP server uses an API token today. OAuth sign-in is in progress; when it ships, this page will show it first and keep the token setup as an advanced option.

Before you start​

  • A PostBoost account. The Free plan works: API, webhooks and MCP are on every plan.
  • An API token: in the dashboard go to Settings → Access Tokens → Create Token and copy it (it is shown once).
  • At least one connected social account, so there is something to post to.

The examples use YOUR_API_TOKEN. Never commit a real token; where the client supports it, read it from an environment variable such as POSTBOOST_API_TOKEN.

Connect​

Either run:

gemini mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" postboost https://postboost.co/mcp/postboost

or add it to ~/.gemini/settings.json (user) or .gemini/settings.json (project). httpUrl selects the Streamable HTTP transport, and $POSTBOOST_API_TOKEN is read from your environment:

~/.gemini/settings.json
{
  "mcpServers": {
    "postboost": {
      "httpUrl": "https://postboost.co/mcp/postboost",
      "headers": {
        "Authorization": "Bearer $POSTBOOST_API_TOKEN"
      }
    }
  }
}

Verify​

Type /mcp inside Gemini CLI, or run gemini mcp list. postboost should show CONNECTED with its tools.

Try it​

Ask the agent things like:

  1. "List my PostBoost social accounts."
  2. "Schedule a LinkedIn and X post for tomorrow at 9:00 saying our 1.8 release is live, with a link to https://postboost.co/docs/changelog."
  3. "Show me posts that failed in the last 7 days and tell me why each one failed."

The agent calls PostBoost tools (list accounts, create post, list posts) and shows you each call before running it, depending on your client's approval settings.

Troubleshooting​

ProblemWhat to check
401 UnauthenticatedThe header must be exactly Authorization: Bearer <token>. Create a new token if the old one was deleted.
403 on a toolAdmin-only tools (workspaces, users, subscriptions) need a token from an admin user.
Tool list is emptyThe server did not connect. Check the URL is https://postboost.co/mcp/postboost (no trailing path), then restart or reload the client.
Network or timeout errorsThe endpoint uses Streamable HTTP. Make sure your client version supports remote HTTP MCP servers and that a proxy is not blocking postboost.co.