How to post to X (Twitter) from Gemini CLI

1. 1

   Create an API key and add planpo.st to Gemini CLI

   Make a scoped key in planpo.st under Settings. Add a planpost entry under mcpServers in settings.json, in ~/.gemini globally or .gemini in a project. For the hosted server the key is httpUrl, not url. The local entry runs npx -y planpost-mcp with the key in env.

2. 2

   Confirm the server is connected

   Run /mcp inside Gemini CLI and check that planpost is listed with its tools.

3. 3

   Connect X

   Connect the X account in the planpo.st dashboard under Connections. OAuth needs a person at a browser, so the agent cannot do this part alone; it can call get_connection_link and hand you the URL to open.

4. 4

   Know what the post needs

   An X post needs text of 280 characters or fewer with no URL in it. That includes bare domains such as example.com, which X turns into links by itself. Nothing in platformSettings is required.

5. 5

   Ask in your terminal

   Say what to post and when. Gemini CLI finds the X connection, creates the post, and tells you whether it was scheduled or kept as a draft, with the reason.

{
  "mcpServers": {
    "planpost": {
      "httpUrl": "https://mcp.planpo.st/mcp",
      "headers": { "Authorization": "Bearer pk_live_xxx" },
      "timeout": 10000
    }
  }
}

{
  "mcpServers": {
    "planpost": {
      "command": "npx",
      "args": ["-y", "planpost-mcp"],
      "env": { "PLANPOST_API_KEY": "pk_live_xxx" }
    }
  }
}

There is nothing to upload for X, since posts go out as text. When the same post also targets a network that takes images, Gemini CLI sets platformMedia so the picture goes there and X gets the words.