Gemini + Mastodon

Mastodon posts with Gemini and Bolta

Turn your changelog into social drafts from Gemini CLI. Parts of the Gemini route are not confirmed yet, and the note below says which. Nothing goes live on Mastodon until you say yes.

One extension install, then a browser sign-in. No key to copy unless you run headless.

GeminiBolta connected
You

Read the top entry in CHANGELOG.md and draft a Mastodon post about it inside my instance's limit

Illustration of the reply: Bolta returns a draft showing the connected account and the scheduled time, with Approve, Edit and Reject actions.

Illustration. Your drafts show your real text, account and time.

What is and is not confirmed

Read this before you set up Gemini

  • Confirmed from Google's docs: Gemini CLI reads remote MCP servers, can start OAuth sign-in with /mcp auth, and installs extensions from a GitHub URL. Bolta's extension uses that format.
  • Not confirmed: nobody at Bolta has run a full draft, review and schedule flow through Gemini CLI. Claude Code is the most tested path.
  • Google's announcement says Gemini CLI stopped serving Google AI Pro, Google AI Ultra and free Code Assist for individuals users on June 18, 2026. Paid Gemini API key users and Standard or Enterprise Code Assist license holders keep it.
  • Not confirmed: whether Antigravity CLI, the replacement, accepts Bolta's extension or MCP server. The Gemini web and mobile app is also untested.
Bolta on Mastodon

What Bolta does on Mastodon

The text limit on Mastodon is set by your own instance, and Bolta reads it for the connected account instead of using one fixed number. The usual limit is 500 characters.

  • Text posts, within the limit your instance sets.
  • Public posts by default, or another visibility if you set it.
Limits and format

Mastodon limits and format rules

Bolta's posting rules for your workspace (get-posting-rules) win if they differ from this page.

Not promised for Mastodon from Gemini: Polls, threads and instance-specific features. None is confirmed for Bolta. Any rule from a particular instance. Each instance sets its own, so check yours.

Mastodon limits and format rules
What to knowMastodon's own ruleWhat Bolta does
Post lengthNot stated on this page.Set by your instance. Bolta reads it per account, and the usual limit is 500. Text over the limit is trimmed back to the last whole sentence or word that fits.
VisibilityNot stated on this page.Public unless you set another visibility.
FormattingNot stated on this page.Mastodon posts are plain text here. Markdown is flattened, and #hashtags and @mentions stay as typed.
Finding conversationsNot stated on this page.Hashtag-based. The query is folded into a single tag, because full-text status search is unavailable on most instances.
Best practices

Gemini jobs for Mastodon, and how to write them

  • Write launch posts from release notes that sit in your repo, not in a browser tab
  • Set up a weekly routine that drafts posts for your review, with the plan shown first
  • Ask for your instance's limit before drafting. It differs from instance to instance.
Prompts

Example prompts for Mastodon

Things to type in Gemini. Each one asks for a draft and shows you the text first.

Read the top entry in CHANGELOG.md and draft a Mastodon post about it inside my instance's limit

What is waiting for my approval in Bolta?

Turn the release notes into a Mastodon post with one relevant hashtag and show it to me first

Every Monday, draft two posts from the week's merged changes. Show me the plan first.

Review

Bolta saves a draft, you read the exact text, you say yes

  1. 01

    Bolta saves a draft

    Gemini asks Bolta for the Mastodon post in your brand voice (save-post). A saved draft is never public.

  2. 02

    You read the exact text

    On Mastodon the exact text includes its visibility, because the default is public, and where the limit for your instance would cut it.

  3. 03

    You say yes

    Only then does Bolta schedule or publish (publish-post), in your workspace's timezone. Safe Mode, client sign-off and brand approval rules still apply.

Gemini and Bolta

Using Gemini for Mastodon

Parts of this route are not confirmed. The note above says which.

For Mastodon, Gemini, from Google, reaches Bolta through Gemini CLI extension (or MCP server added by hand). Sign-in: Sign in (OAuth), or API key for headless runs. The Mastodon account itself is connected inside Bolta, not in Gemini.

Gemini CLI is a terminal tool, separate from the Gemini web and mobile apps. Per Google, personal Google AI Pro and Ultra plans moved to Antigravity CLI on 18 June 2026, so check which Gemini you can run before you plan Mastodon work.

An illustration from the Gemini guide, not real output. You ask: How did my last five posts do? Suggest what to post next. The reply goes along these lines: Here are the numbers for the account you named, with the best performer first. A next post idea is below. I have not drafted anything yet. Read only. No draft created.

On June 18, 2026 Google moved Google AI Pro, Google AI Ultra and free Code Assist for individuals users from Gemini CLI to Antigravity CLI. Per Google, Gemini CLI stays available with a paid Gemini API key or a Gemini Code Assist Standard or Enterprise license.

Ask it to read the draft back. Edit in Bolta or in the chat, then approve the exact text.

Treat the bolta_sk_ key like any secret. Keep it in an environment variable or secret store, not in a repo. The exact Gemini command with Bolta was not run by us, so test it on a draft first.

  • Send a draft to a teammate. If a colleague should look at the release post first, submit the draft for review instead of approving it yourself. The reviewer must be a creator or client reviewer on the brand, not an owner or admin, and they get an email.
  • Set up a weekly drafting routine. Describe the cadence, read the plan Gemini shows you, and save it switched off. It only starts after a separate yes.
  • It finds the brand and the connected accounts. Before drafting it asks Bolta which brands you ticked at sign-in and which social accounts sit under each.
  • You say yes to the exact text. Only after you approve the wording does Bolta schedule or publish it. If Bolta refuses an action, Gemini stops there.
  • Setup: Create a Bolta account and add a brand. Sign up at bolta.ai and add at least one brand. Connect a social account if you want to publish, since Bolta cannot post to an account that is not connected.
  • Setup: Install the extension from your normal terminal. Run gemini extensions install https://github.com/boltaai/bolta-skills outside of Gemini, and confirm the security prompt. The extension brings the Bolta connection and the Bolta skill together.
  • Remote MCP server added by hand with a Bearer key. gemini mcp add --transport http with an Authorization header and a bolta_sk_ key. Gemini documents a headers option. We did not run this exact command against Bolta.
  • Replies, edits and approvals in a chat need Gemini CLI open. The same actions can be done in the Bolta dashboard.
  • gemini mcp add with an API key. Choose this for servers, containers or scheduled runs with no browser. You add the server with an Authorization Bearer header and a bolta_sk_ key. This follows Gemini's documented headers option, but Bolta has not run this exact command end to end. Keep the key out of shared shell history and repos.
Connect

Connect Gemini to Bolta

One extension install, then a browser sign-in. No key to copy unless you run headless.

FAQ

Mastodon questions, answered for Gemini

What is the Mastodon character limit for a post from Gemini?
It depends on your instance. Bolta reads the limit for the connected account, and the usual limit is 500 characters. Anything over it is trimmed back to the last whole sentence or word.
Are Mastodon posts from Gemini public?
Yes, unless you set another visibility. Say who may see the post when you ask, and check it when you read the draft.
Do I need an API key to connect Bolta to Gemini CLI?
Not for the extension. You sign in through a browser with /mcp auth bolta and tick the brands. You only need a bolta_sk_ key if you add the server by hand with gemini mcp add, which is meant for headless runs.
Is Gemini CLI still available after June 18, 2026?
Not for Google AI Pro, Google AI Ultra or free Code Assist for individuals users, who moved to Antigravity CLI. Users with a paid Gemini API key or a Standard or Enterprise Code Assist license keep Gemini CLI. Check Google's announcement for your own plan.
Does Bolta work in Antigravity CLI?
We have not confirmed it. Google says extensions became Antigravity plugins and its announcement does not mention MCP, so we cannot say whether Bolta's extension or server loads there.
Does it work in the Gemini web or mobile app?
Untested. It is a different product from Gemini CLI, and Bolta has not confirmed it connects there. The setup on this page is for Gemini CLI.
Does Gemini publish Mastodon posts without my yes?
No. Nothing is approved, scheduled or published until you say yes to that Mastodon post. Whether Gemini completes the connection is not fully confirmed, so read the note above first.

More from Gemini

Gemini can work with the other networks Bolta publishes to. Each page has its own limits and review notes.

Mastodon from other AI agents

The same Mastodon limits apply whichever agent asks. The connection and the setup are what change.

Try a Mastodon draft from Gemini

Connect Gemini, ask for a Mastodon draft and read the exact text. Nothing goes live until you say yes.