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 AI & API 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.
- Step 1
Add the server
Run the command in your terminal. Gemini CLI adds Postbase as a remote MCP server over HTTP.
- Step 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.
- Step 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.
Postbase connected- 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, with media, to any channels.get_postCheck each channel: published with its link, or why it failed.update_postEdit or reschedule a post before it goes out.retry_postSend a post again where it failed.get_analyticsSee which posts did best: likes, views and more.list_mediaFind images and videos in your media library.add_mediaAdd an image or video from a link.list_scheduledReview what's queued to publish.cancel_postPull a scheduled post before it goes out.Ten tools, nothing surprising
Gemini CLI can create, edit and check posts and threads, retry what failed, read analytics, add media and cancel a post. It can't delete anything or change your account.
Take access back in one click
Gemini CLI shows up under Connected apps on your AI & API page. Revoke it and it's cut off immediately.
Tools you've signed in to Postbase from. Revoking cuts off their access 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 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 AI & API 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?
Posts and threads go to X, LinkedIn, Bluesky and Mastodon, and videos to YouTube, with images or video from your Postbase media library. TikTok posts are saved as drafts, because TikTok requires you to choose who sees each one in the Postbase composer.
How do I stop Gemini CLI posting for me?
Open AI & API → 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 as a connector and let Claude post.
- ChatGPT
Add Postbase as an MCP app and let ChatGPT post.
- Claude Code
One command, then post straight from your terminal.
- Cursor
Install in one click and post from Cursor's agent.
- VS Code
Let GitHub Copilot draft and schedule your posts.
- Windsurf
Give Cascade a publish button for every network.
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