Gemini CLI + Xholic

Post to X from Gemini CLI

One command adds Xholic to Gemini CLI. Turn your work into posts, schedule them at your best times and see what's working on X, from your terminal.

  • gemini mcp add, then sign in in your browser
  • Writes from your repo and notes
  • Works in every project with --scope user

No card needed · Nothing to cancel

How to add the Xholic MCP server to Gemini CLI

Connect your X account to Xholic first (one click with X's official sign-in, during the free trial). Then:

  1. Step 1: Add Xholic

    Run this in your terminal. -s user makes Xholic available in every project.

    Terminal
    gemini mcp add -s user --transport http xholic https://api.xholic.ai/mcp
  2. Step 2: Sign in

    Start Gemini CLI. On first use it opens your browser to sign in to Xholic; if it doesn't, run /mcp auth xholic. Pick what it may do and which X accounts it can use, then approve.

  3. Step 3: Ask Gemini

    Ask: "Use Xholic: what should I post today?"

Gemini CLI · with Xholic

Use Xholic: look at the commits since Friday and tell me which one is worth a post.

  • → get_writing_kit
  • → check_draft

The caching change is your best story: 840 ms down to 120 ms. Here's a draft in your voice. It passed the writing check. Queue it for tomorrow at 9:15?

Server address: https://api.xholic.ai/mcp. Steps checked against Gemini CLI MCP docs on November 2, 2026.

Which way should I connect Gemini CLI?

Ways to connect Gemini CLI to Xholic
WayHowSign-inBest for
gemini mcp addRecommendedgemini mcp add -s user --transport http xholic …OAuth in your browserGemini CLI users
settings.jsonAdd xholic with "httpUrl" under mcpServers in ~/.gemini/settings.jsonOAuth in your browserChecking config into a dotfiles repo
Agent skill + CLInpx -y skills@1.7.1 add sjcodebook/xholic-agent -gxholic login (browser), or XHOLIC_API_KEY in CIScripts, CI and agents that prefer commands

What can Gemini CLI do with Xholic?

Xholic gives Gemini CLI your X account, your audience and the actions to grow it. Gemini CLI does the thinking; Xholic does the posting, scheduling and tracking.

What is Gemini CLI?

Gemini CLI is Google's open-source AI agent for the terminal. It reads your files, runs commands with your approval and supports remote MCP servers over Streamable HTTP. When a server needs sign-in, it finds the OAuth endpoints itself and opens your browser.

  • Open source

    Gemini CLI is open source and runs in your terminal on macOS, Linux and Windows.

  • Automatic sign-in

    It discovers Xholic's OAuth sign-in on first use and stores the token for you.

  • User or project

    Add Xholic for every project with --scope user, or one project with the default scope.

What can you ask Gemini CLI to do in Xholic?

You decide what Gemini CLI can do

  • Choose read, write and publish access when you approve Gemini CLI. Untick publish and it asks you first.
  • In apps that can ask, every post and DM waits for your yes, showing exactly what goes out.
  • Gemini CLI only sees the X accounts you tick.
  • Everything it does is logged on its connection, with undo where X allows.
  • Billing, X account connections and security settings stay inside the Xholic app.
  • Disconnect it in one click from Settings → API / MCP / CLI.

FAQs

Gemini CLI and Xholic: questions

Setup, safety and pricing for using Xholic in Gemini CLI.

Is Gemini CLI the same as the Gemini app?

No. Gemini CLI is Google's terminal agent, which supports remote MCP servers like Xholic. The Gemini chat app is a separate product.

Gemini CLI doesn't sign in to Xholic. What should I do?

Run /mcp to check xholic's status, then /mcp auth xholic to sign in again. Make sure you added it with --transport http; the default transport is for local servers.

Is Xholic free to use with Gemini CLI?

Xholic has a 7-day free trial with no card needed. After that, the MCP server, API and CLI are included in every plan, from $19 a month. Gemini CLI does the writing on its own plan, so Xholic doesn't charge for its AI.

Does Gemini CLI need my X password?

No. You connect your X account to Xholic once through X's official sign-in. Gemini CLI then signs in to Xholic through your browser, so it never sees your X password or a key.

Can Gemini CLI post to X without asking me?

Only if you allow it. When you approve Gemini CLI you choose what it can do: read, write drafts and lists, and publish. Untick Publish and it asks you first with a one-click link. In apps that can show a confirmation, every post and DM waits for your yes and shows exactly what goes out. Authentication and permissions

Which X accounts can Gemini CLI use?

Only the ones you tick when you approve it, with one of them as the default. You can change that or disconnect Gemini CLI anytime in Xholic under Settings → API / MCP / CLI, and everything it does is logged there.

Use Xholic in every agent you use

One Xholic account works in all of them at once, with the same voice, memory and queue. People who use Gemini CLI often also connect Claude Code, Codex and Kimi Code.

Desktop and chat apps

Building your own? See the API, MCP server and CLI, or read the MCP docs.

Grow on X from Gemini CLI

Start the free trial, connect your X account, then connect your AI. It takes about two minutes.

No card needed · Nothing to cancel

Compare plans

Live demo: no sign-up or login needed · takes about 2 minutes