logo
Gemini + Postiz

Schedule Social Media Posts with Gemini

  • One command installs the Postiz extension in Gemini CLI
  • Draft, schedule and publish to 30+ platforms by asking
  • Also works as a custom app in the Gemini web app
Start for $0
View in Extensions Gallery

Postiz is the agentic social media scheduling platform that Gemini drives through the Postiz extension for Gemini CLI. Please make sure there is always a human in the loop. Last updated: September 2026. Using a different agent? See Claude Code, Codex, or the full agent list.

How do I connect Postiz to Gemini?

The Postiz extension is listed in the Gemini CLI extensions gallery. One install command adds both the Postiz skill and the hosted MCP server, and Gemini signs you in with OAuth on first use. No API key, no config files.

1Install
about a minute

Run this in your shell

One command installs the Postiz skill and registers the hosted Postiz MCP server. Then start gemini.

Terminal
gemini extensions install https://github.com/gitroomhq/postiz-agent

No API key needed. Gemini opens your browser to sign in to Postiz on the first call; run /mcp auth postiz to sign in again. Extension commands run in your shell, not inside the interactive CLI.

Prefer the Gemini web app? Add the as a custom connected app under Settings, then Connected Apps at gemini.google.com. The same link works with gemini mcp add --transport http postiz. Details on the Postiz MCP page.

2Ask
live in Postiz

Ask Gemini to post for you

Once installed, Gemini calls the Postiz tools. Posts publish at the scheduled time even after you close the terminal.

Schedule a post to X and LinkedIn for tomorrow at 9am announcing the v2 release. Attach ./assets/release.png

Uploaded release.png through the postiz CLI and scheduled 2 posts for 09:00 tomorrow: X and LinkedIn, both with the image. Want a Reddit post for r/SaaS too?

via PostizXLinkedin

Also try

List my connected channelsTurn CHANGELOG.md into an X threadPlan next week of posts
  1. 1Install Gemini CLI (Node.js 20+) and sign in with your Google account
  2. 2Run gemini extensions install in your shell, not inside the interactive CLI
  3. 3Start gemini, ask it to list your channels and approve the Postiz sign-in
  4. 4Optional: npm install -g postiz and postiz auth:login for uploads from disk

The same MCP link works in any MCP-capable assistant. See the Postiz MCP server page for Claude, ChatGPT, Cursor, and others.

One extension powers every channel you run

Connect your accounts in Postiz once. From then on Gemini can post to any of them from the terminal, and Postiz publishes at the time you set.

XLinkedInInstagramFacebookThreadsRedditYouTubeTikTokPinterestBlueskyDiscordSlackGoogle BusinessTelegramMastodonDribbbleWordPressMediumHashnodeDev.toTwitchKickWarpcastNostrLemmyVKMeWeWhopSkoolListmonk

Gemini CLI extension vs Gemini app: what is the difference?

Both routes reach the same Postiz account through the same MCP server. The extension adds the Postiz skill on top, which is what lets Gemini upload files from your disk and run in scripts.

CapabilityGemini CLI extensionGemini web app (custom app)
Where you add itYour terminal, with gemini extensions installgemini.google.com, Settings > Connected Apps > Custom apps
What gets installedThe postiz skill plus the hosted Postiz MCP serverThe Postiz MCP server only
Sign-inOAuth in the browser on first use; /mcp auth postiz to repeatOAuth on the Postiz approval page
List channels, platform rules, analyticsYesYes
Draft, schedule, and publish postsYesYes
Generate images and videos, clip long videosYes, through the MCP toolsYes, through the MCP tools
Attach local files from diskYes, the skill runs the postiz CLI to upload themNo, media has to come from a URL or a generation tool
Scripts, cron jobs, CIYes, run gemini in non-interactive mode with -pNo, chat only
AvailabilityAnywhere Gemini CLI runsPersonal Google Accounts, 18+, US, English; then also in the Gemini mobile app

Recommendation: start with the extension. Use the custom connected app when you want to post from the Gemini mobile app.

What can Gemini do with Postiz?

Gemini can write, schedule, and publish posts for every channel connected to your Postiz account, create the media that goes with them, and do it all from the terminal you already work in.

One Command to Install

gemini extensions install adds the skill and the MCP server together. No JSON to edit, no API key to paste.

30+ Platforms

Post to X, LinkedIn, Reddit, Instagram, YouTube, TikTok, and more from one Gemini prompt. Platform rules are read from Postiz, not guessed.

Uploads from Disk

The bundled skill runs the postiz CLI, so Gemini can attach the screenshot or video sitting in your project folder to a post.

Plan & Schedule Ahead

Ask Gemini to plan a week of posts and pick the times. Postiz publishes them on schedule after you close the terminal.

Generate Images & Videos

Through the MCP tools Gemini can generate images and videos in Postiz, clip long videos into shorts, and attach them to posts in the same request.

Scripts and Cron Jobs

Run Gemini CLI non-interactively with -p from a cron job or CI step and let it schedule the day's posts while you sleep.

What is the Postiz extension for Gemini CLI?

Gemini CLI extensions package prompts, MCP servers, commands, and agent skills into one installable unit. The Postiz extension is the postiz-agent repository itself: it ships a gemini-extension.json that points Gemini at the hosted Postiz MCP server and a SKILL.md that teaches Gemini the posting workflow and the postiz CLI.

How Gemini Uses Postiz

Once the extension is installed, Gemini loads the Postiz tools at startup and calls them when you ask it to post.

  • The extension registers the Postiz MCP server and the postiz skill
  • Gemini signs you in to Postiz over OAuth on the first call
  • It lists your connected channels and reads each platform's rules
  • It composes posts in the right format, uploads media, and schedules them
  • The skill falls back to the postiz CLI for files on your disk
gemini-extension.json (from the repo)
{
  "name": "postiz",
  "description": "Postiz social media automation:
    schedule, draft, and publish posts ...",
  "mcpServers": {
    "postiz": {
      "httpUrl": "https://mcp.postiz.com/mcp-oauth-dynamic"
    }
  }
}

# plus SKILL.md -> the postiz skill
# (drives the postiz CLI for uploads)

Source and manifest: gitroomhq/postiz-agent on GitHub. Tool reference in the MCP docs.

What can I ask Gemini to post?

Anything you would ask a teammate. Name the channels, the timing, and the tone. Gemini reads the platform rules from Postiz and handles the rest.

Release

Ship a release post with an image

Schedule a post to X and LinkedIn for tomorrow at 9am announcing the v2 release. Attach ./assets/release.png

Changelog

Turn a changelog into a thread

Turn the changelog in CHANGELOG.md into a 4-part X thread and a LinkedIn post. Space them across this week.

Cron job

Schedule the week from a file

gemini -p "Read content/this-week.md and schedule each post to the channel and time it names through Postiz."

Community

Share with your community

Draft a Reddit post for r/SaaS about the v2 release and drop the link in our Discord announcements channel.

Which platforms can Gemini post to?

Gemini can post to every platform Postiz supports, 30+ in total. Connect your accounts in Postiz once, then name them in your prompt.

Want platform-by-platform settings and prompts? The Claude Code guide has a page for each platform, and the same Postiz settings apply in Gemini CLI.

Gemini CLI vs the Gemini app vs the Gemini API: which route do I need?

Google ships Gemini in several shapes. Postiz works with all of them, but the setup differs. Pick the one that matches where you type your prompts.

Gemini CLI (this page)

Google's open-source terminal agent. Install the Postiz extension from the gallery and post from the terminal, from scripts, or from cron jobs.

Gemini web and mobile app

The chat assistant at gemini.google.com. Add the Postiz MCP link as a custom connected app (see the connect section above) and post by chatting. Subject to Google's custom-app availability.

Gemini API in your own agent

Building your own agent on Gemini models? Give it the Postiz MCP link as a remote server, or call the Postiz public API directly. See the agent hub for both.

Using Claude, ChatGPT, Cursor, or another agent? See the Postiz Agent page for every supported agent.

Pricing, security, and troubleshooting

How much does it cost?

The extension has no separate charge. Postiz starts with a 7-day free trial, then plans run from $29 per month for 5 channels to $99 per month for 100 channels. Every plan includes AI video and clipping minutes, and AI images are included from the Team plan up.

Compare Postiz plans

How is access secured?

Gemini connects through OAuth: you sign in to Postiz in the browser and approve access. Tokens are stored by Gemini CLI locally, and no social media password or API key is placed in a prompt. Gemini only reaches the channels already connected in Postiz. Uninstall the extension to disconnect.

Something not working?

  • No Postiz tools: run /extensions list, then /mcp list. Restart gemini after installing, since extensions load at startup.
  • Sign-in errors: run /mcp auth postiz and finish the Postiz approval in the browser.
  • Gemini can't attach a local file: install the CLI with npm install -g postiz and run postiz auth:login.
  • Gemini can't see any channels: connect your social accounts in Postiz first, then ask again.

Frequently Asked Questions

How do I connect Postiz to Gemini?

Install the Postiz extension for Gemini CLI: run gemini extensions install https://github.com/gitroomhq/postiz-agent in your shell. The extension bundles the Postiz skill and the hosted Postiz MCP server. Start gemini, ask it to list your channels, and sign in to Postiz in the browser window it opens. No API key is needed for posting.

Does Postiz work with the Gemini app, not just Gemini CLI?

Yes, through Google's custom connected apps. In the Gemini web app open Settings, then Connected Apps, add a custom app, and paste https://mcp.postiz.com/mcp-oauth-dynamic. Google currently limits custom apps to personal Google Accounts for users 18 and over in the US, in English. Once connected on the web it also works in the Gemini mobile app.

Do I need a Postiz API key for Gemini?

Not for posting. The MCP server bundled in the extension signs you in with OAuth, so Gemini only reaches the channels already connected to your Postiz account. The one exception is uploading files from your disk: the skill runs the postiz CLI for that, which needs postiz auth:login or a POSTIZ_API_KEY from your Postiz settings.

What can Gemini do with Postiz?

Gemini can list your connected channels, read each platform's posting rules, draft posts in the right format, schedule or publish them, build threads and comments, generate images and videos through Postiz, clip long videos into shorts, and plan a content calendar across 30+ platforms. You describe the outcome and Gemini calls the matching Postiz tools.

What is the difference between the extension and gemini mcp add?

gemini mcp add --transport http postiz https://mcp.postiz.com/mcp-oauth-dynamic registers only the MCP server. The extension registers the same server and also installs the Postiz skill, which teaches Gemini the posting workflow and lets it upload local media through the postiz CLI. Use the extension unless you specifically want a bare MCP connection.

How do I update or remove the Postiz extension?

Run gemini extensions update postiz to pull the latest version, or gemini extensions update --all to refresh every extension. Remove it with gemini extensions uninstall postiz. You can also disable it for one project with gemini extensions disable postiz --scope workspace. Inside the CLI, /extensions list shows what is installed.

Gemini does not show the Postiz tools. What should I check?

Run /extensions list to confirm the extension installed, then /mcp list to see whether the postiz server connected. If it shows an auth error, run /mcp auth postiz and finish the Postiz sign-in in the browser. Extensions are loaded at startup, so restart gemini after installing. Remember that gemini extensions install runs in your shell, not inside the interactive CLI.

Can Gemini post to social media on a schedule while I am away?

Yes. When Gemini schedules a post, Postiz stores it and publishes at the chosen time even after you close the terminal. For unattended workflows, run Gemini CLI non-interactively from a cron job or CI step with gemini -p and a prompt that tells it what to schedule. Keep a human reviewing what goes out.

Is it safe to let Gemini post to my social accounts?

Gemini signs in to Postiz with OAuth, so no social media passwords or API keys are shared, and it can only reach channels already connected in Postiz. Revoke access any time from your Postiz account or by uninstalling the extension. Ask Gemini to draft or schedule first and review before publishing.

Which social media platforms can Gemini post to?

Any channel connected to your Postiz account. Postiz supports 30+ platforms, including X (Twitter), LinkedIn, Instagram, Facebook, Threads, Bluesky, Reddit, YouTube, TikTok, Pinterest, Discord, Slack, Telegram, Mastodon, Medium, Dev.to, WordPress, and Google My Business. Connect the accounts once in Postiz, then name them in your prompt.

Is it free to start?

Yes. Postiz comes with a 7-day free trial, and paid plans start at $29 per month. The extension, the MCP server, and the skill are included with every account at no extra cost. Gemini CLI itself is free to use with a Google account. See postiz.com/pricing for the current plans.

Related: Postiz Agent for any AI agent, Postiz MCP server, Claude Code, Codex, Kimi K3, DeepSeek, Pricing. Last updated: September 2026.

Let Gemini run your social media

One install command, one sign-in, and Gemini can post everywhere you already are.

Get the Extension