NewGenerate AI UGC videos with your AI agent using agent-media

Run Your Social Media from Gemini

Gemini can schedule and publish social media posts through Postiz. Install the Postiz extension for Gemini CLI with one command, sign in with your Postiz account, and ask Gemini in plain English to draft, schedule, and publish posts across 30+ platforms including X, LinkedIn, Instagram, and Reddit. The same MCP link also works as a custom connected app in the Gemini web app.

View in Extensions Gallery

Start for $0

View Docs

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.

Option 1: Gemini CLI extension (recommended)

Run this in your shell, then start gemini. Skill and MCP server included.

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

1Install Gemini CLI. Skip this if you already use it. Gemini CLI needs Node.js 20 or newer: run npm install -g @google/gemini-cli (or brew install gemini-cli), start it with gemini, and sign in with your Google account.
2Install the Postiz extension. In your shell, not inside the interactive CLI, run gemini extensions install https://github.com/gitroomhq/postiz-agent. This installs the postiz skill and registers the hosted Postiz MCP server in one step.
3Sign in to Postiz. Start gemini and ask it to list your connected channels. On the first Postiz call Gemini CLI opens your browser to sign in to Postiz over OAuth. Approve access once; run /mcp auth postiz if you ever need to sign in again.
4Optional: install the Postiz CLI for uploads. The skill drives the postiz command for image and video uploads from disk. Run npm install -g postiz and then postiz auth:login (or export POSTIZ_API_KEY) if you want Gemini to attach local files to posts.

Terminal

# Install Gemini CLI (Node.js 20+)
npm install -g @google/gemini-cli

# Install the Postiz extension
gemini extensions install https://github.com/gitroomhq/postiz-agent

# Optional: Postiz CLI for uploads from disk
npm install -g postiz
postiz auth:login

# Start Gemini
gemini

Inside Gemini CLI

/extensions list      # confirm postiz is installed
/mcp list             # postiz server status
/mcp auth postiz      # sign in to Postiz again

> List my connected social media channels

Extension commands run in your shell. gemini extensions install, update, and uninstall are not available inside the interactive CLI. Run them from your normal terminal prompt, then start gemini. Update later with gemini extensions update postiz.

Option 2: Gemini web app, custom connected app

Prefer chatting at gemini.google.com? Google lets you add any MCP server as a custom connected app. This is Google's own custom-app flow rather than an official Postiz listing, and Google currently limits it to personal Google Accounts for people 18 and over in the US, in English. After you connect it on the web it also works in the Gemini mobile app.

1Open gemini.google.com, then Settings and Connected Apps
2Under Custom apps, choose Add a custom app and paste the Postiz MCP link
3Click Next and sign in to Postiz when the approval page opens
4Ask Gemini to list your connected channels to confirm the app is working

Your Postiz MCP link (paste as the custom app URL)

https://mcp.postiz.com/mcp-oauth-dynamic

Everyone uses the same link. Access is tied to your Postiz account when you sign in. The same link also works with gemini mcp add --transport http postiz if you only want the MCP server in Gemini CLI without the skill.

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

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.

Capability	Gemini CLI extension	Gemini web app (custom app)
Where you add it	Your terminal, with gemini extensions install	gemini.google.com, Settings > Connected Apps > Custom apps
What gets installed	The postiz skill plus the hosted Postiz MCP server	The Postiz MCP server only
Sign-in	OAuth in the browser on first use; /mcp auth postiz to repeat	OAuth on the Postiz approval page
List channels, platform rules, analytics	Yes	Yes
Draft, schedule, and publish posts	Yes	Yes
Generate images and videos, clip long videos	Yes, through the MCP tools	Yes, through the MCP tools
Attach local files from disk	Yes, the skill runs the postiz CLI to upload them	No, media has to come from a URL or a generation tool
Scripts, cron jobs, CI	Yes, run gemini in non-interactive mode with -p	No, chat only
Availability	Anywhere Gemini CLI runs	Personal 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

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

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)

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.

You

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

Gemini

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

You

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

Gemini

Drafted a 4-part thread and a LinkedIn
summary. Scheduled Tue 10:00 (X) and
Thu 09:30 (LinkedIn). Both are in Postiz
as scheduled posts you can still edit.

Cron job (non-interactive)

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

Gemini

Scheduled 5 posts from this-week.md:
  Mon 09:00 LinkedIn, Tue 12:00 X,
  Wed 10:00 Instagram, Thu 09:00 X,
  Fri 11:00 Bluesky.

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.

X (Twitter)LinkedInInstagramFacebookRedditYouTubeTikTokPinterestThreadsBlueskyMastodonDiscordSlackTelegramTwitchKickMediumDev.toHashnodeWordPressDribbbleFarcasterLemmyNostrVKGoogle My BusinessListmonk

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 (Option 2 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. Postiz is open source, so self-hosting is free.

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 the open-source version can be self-hosted for free. 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.