Post from the terminal
One command adds Postbase to Gemini CLI. Ask it to announce a release or schedule a week of posts, and it handles each network's version for you.
Cancel anytime · or self-host for free
Connect Gemini CLI from the Developers page
Use your API key to automate Postbase — hook up an AI agent over MCP, script it from the CLI, or call the REST API directly.
API keys
A key authenticates the MCP server, the REST API, and the CLI. Shown once — store it safely.
pb_live_…9c1eMCP client configuration
Connect the Postbase MCP server to your AI tool so it can schedule and publish for you.
Authentication
No key to manage — your tool signs in through Postbase.
Client
Run this to add the remote server to Gemini CLI.
gemini mcp add postbase --transport http https://mcp.postbase.so/mcpCopyConnected apps
Tools you've signed in to Postbase from. Revoking cuts off their access immediately.
Set up Postbase in Gemini CLI
About a minute, and you only do it once.
- 1
Add the server
Run the command in your terminal. Gemini CLI adds Postbase as a remote MCP server over HTTP.
- 2
Sign in to Postbase
A browser window opens. Sign in and pick the workspace the client may post to. There's no API key to copy or store.
- 3
Ask for a post
Tell Gemini CLI what to post, where and when. It checks your channels, writes the post (or a separate version per network) and schedules it. Every post shows up in your Postbase calendar.
gemini mcp add postbase --transport http https://mcp.postbase.so/mcpWhat to ask Gemini CLI
Plain language works. These are a few things people ask for.
“Write a thread for X about today's release notes and schedule it for 10am.”
“Draft one post for LinkedIn and one for Bluesky about our new docs site.”
“List the posts scheduled for this week.”
You stay in control
Gemini CLI gets a small set of tools, and everything it does shows up in Postbase.
list_channelsSee connected accounts and their platforms.create_postDraft or schedule a post/thread to any channels.list_scheduledReview what's queued to publish.cancel_postPull a scheduled post before it goes out.Four tools, nothing surprising
Gemini CLI can list your channels, create posts and threads, check the queue and cancel a post. It can't delete anything or change your account.
Tools you've signed in to Postbase from. Revoking cuts off their access immediately.
Take access back in one click
Gemini CLI shows up under Connected apps on your Developers page. Revoke it and it's cut off immediately.
Every post Gemini CLI schedules lands in your calendar
Agent posts sit next to yours. Review, edit or cancel them before they go out.
Networks Gemini CLI can post to
Any account you've connected in Postbase.
- X
Tweets and threads up to 25 posts, with images and video.
- LinkedIn
Posts up to 3,000 characters with images and a first comment.
- Bluesky
Posts and threads up to 300 characters, with up to 4 images.
- Mastodon
Posts and threads on any instance, up to 500 characters.
- TikTok
Videos and photo posts with captions and privacy settings.
- YouTube
Videos and Shorts with a title and description.
Frequently asked questions
Can I use an API key instead of signing in?
Yes. Create a key on the Developers page and add the @postbasehq/mcp npm package to the mcpServers block of ~/.gemini/settings.json with POSTBASE_API_KEY set.
What can Gemini CLI do in my Postbase account?
Four things: list your connected channels, create a draft or scheduled post (or thread), list what's queued, and cancel a scheduled post. It can't delete posts, disconnect accounts or change settings.
Which networks can Gemini CLI post to?
Text posts and threads go to X, LinkedIn, Bluesky and Mastodon. TikTok and YouTube need a video, so for those ask for a draft and add the video in the Postbase composer before it's scheduled.
How do I stop Gemini CLI posting for me?
Open Developers → Connected apps in Postbase and click Revoke next to Gemini CLI. Access ends immediately, and anything already scheduled stays in your calendar for you to keep or cancel.
Do I need a paid Postbase plan?
Every plan includes the MCP server, and every plan starts with a 7-day free trial. You can also self-host the open-source version for free.
Other AI tools
- Claude
Add Postbase to Claude as a custom connector and let Claude draft and schedule posts to X, LinkedIn, Bluesky and Mastodon.
- Claude Code
One command adds Postbase to Claude Code.
- Cursor
Add the Postbase MCP server to Cursor in one click, and let its agent write and schedule launch posts and threads to your social accounts..
- VS Code
Add the Postbase MCP server to VS Code with one command and let GitHub Copilot's agent draft and schedule posts to X, LinkedIn, Bluesky and Mastodon..
- Windsurf
Add the Postbase MCP server to Windsurf's Cascade agent and schedule posts to X, LinkedIn, Bluesky and more while you code..
Ready to get started?
Connect Gemini CLI in a minute. It drafts and schedules, and you see every post in your calendar.
Cancel anytime · or self-host for free
PostbaseCopy your key now — you won't see it again.
pb_live_Qm7xT2vLr9KcH0sWbN8y…4f2aCopyAuthentication
Client