Gemini CLI + Posteady

Manage scheduled posts
from Gemini CLI

Connect Posteady to Gemini CLI to see this week's scheduled posts from your terminal, cancel what changed, and schedule again.

  • One URL in settings.json
  • Sign in to Posteady in your browser on first use
  • Name a time zone and posts go out at that local time

Connect Posteady to Gemini CLI

Add Posteady to Gemini CLI's settings file. The key is httpUrl.

  1. 1

    Add it to settings.json

    Put the block below under mcpServers in ~/.gemini/settings.json.

  2. 2

    Run gemini and sign in

    Start gemini. The first time it uses a Posteady tool, the Posteady approval window opens in your browser — sign in and click Allow.

  3. 3

    Ask about your schedule

    Ask “Show this week's scheduled posts.” Run /mcp to see the connection status and tools.

~/.gemini/settings.json
{
  "mcpServers": {
    "posteady": {
      "httpUrl": "https://www.posteady.com/api/mcp"
    }
  }
}

This page covers Gemini CLI. In the Gemini web app, you can connect by entering only the server URL under Connected Apps → Custom.

Posteady connects on the Creator plan or above, including during the free trial.

Read the full Gemini CLI guide with screenshots

Things to ask Gemini CLI

Paste these in once you're connected. Naming the account, time, and channel makes results more precise.

  • Schedule one Threads post each weekday next week at 8 a.m. (America/Los_Angeles). Show me drafts first.

  • Show only my scheduled LinkedIn posts, by date.

  • Cancel Thursday's 2 p.m. Threads post and schedule the same text for Friday at 11 a.m.

  • Total my views by channel for posts from the last seven days.

To reschedule, cancel and schedule again

MCP doesn't have a tool to edit a scheduled post yet. To change the time or text, cancel the existing schedule and create a new one — ask Gemini CLI once and it runs both steps.

  • Cancellation uses the scheduled post ID and platform, so the right post is canceled.
  • Add a time zone (e.g. America/New_York) to schedule in that local time; otherwise your workspace time zone applies.
  • Schedules that have already started publishing can't be canceled.

What you can do from Gemini CLI

Your agent calls Posteady's tools to post to your real accounts and read your history — across seven channels: Threads, Instagram, X, LinkedIn, TikTok, YouTube, and Facebook.

  • Publish or schedule

    Post to several channels at once, or schedule for later, in a single request. On X and Threads, several posts go out as a thread.

    publish_post · schedule_post

  • Performance reports

    Read views, likes, and comments for up to 100 posts from the last 90 days, then sum up what worked.

    list_posts

  • Make carousels

    Create a carousel from a topic, text, or link, then post or schedule the finished slides on Instagram as-is.

    create_carousel · get_carousel

  • Review and cancel schedules

    See everything that's scheduled and cancel what changed. For posts that take a while, like videos, check that publishing finished.

    list_scheduled_posts · cancel_scheduled_post · get_publish_status

  • Repost winners

    Reshare your best-performing posts on Threads and LinkedIn.

    repost_post

  • Accounts and workspaces

    Read your connected accounts and workspaces to pick where each post goes. Agencies with many clients just name the workspace.

    list_workspaces · list_accounts · list_media

What you need for Gemini CLI

Where it runs
Terminal (Gemini CLI)
What you need
Gemini CLI installed
How it connects
~/.gemini/settings.json (httpUrl + OAuth)
File uploads
Uploads local files to an upload URL, then posts
Mobile
No (desktop terminal)
Posteady
Posteady Creator plan or above (works during the free trial)

Your agent doesn't post on its own

Access opens only through Posteady sign-in, actions are confirmed before they post, and you can cut access anytime.

  • Sign in, no API keys

    You sign in to Posteady in an OAuth approval window and allow access. No passwords or keys go into the chat, and access tokens renew every hour.

  • Confirmation before posting

    Posteady marks tools with outside effects, like publishing. Apps such as ChatGPT and Claude ask you once more before running them.

  • Same permissions, revoke anytime

    Workspace roles and permissions still apply. Revoke access anytime under Connected AI apps in Posteady settings.

Posteady

FAQ

Still have questions? Feel free to reach out!

Contact us

Yes. In the Gemini web app, open Connected Apps, click Custom, and enter only the server URL https://www.posteady.com/api/mcp. Leave Client ID and Client secret empty. After you connect, you can use it in the Gemini mobile app too. Google requires that you are 18 or older and in the US, use a personal Google Account, use Gemini in English, and keep the Keep Activity setting on.

Use ~/.gemini/settings.json for all projects, or .gemini/settings.json inside a project to use it there only. The key is httpUrl, not url.

Run /mcp auth posteady inside Gemini CLI to sign in through your browser again. You'll need to after revoking the connection in Posteady settings, or after 30 days without use.

If you don't name one, posts are scheduled in your workspace's time zone. Add one, like “9 a.m. tomorrow America/New_York,” to schedule in that local time.

Take back the time you spend on social marketing

No credit card required