Skip to content

Gemini CLI + Wahlu

Post to TikTok from Gemini CLI with Wahlu

Connect Gemini CLI to Wahlu once, then plan, draft and schedule posts for TikTok accounts connected to Wahlu from the Gemini CLI terminal. Every schedule can wait for your approval.

Connect Gemini CLIAll Gemini CLI options
What Gemini CLI can prepare on TikTok

  • Video

    One video with a caption.

  • Photo

    One image. The first 90 characters of the caption become its title.

  • Photo carousel

    Two to 35 images.

Ask Gemini CLI for TikTok posts

Example prompts and the steps to expect. These are illustrations, not recorded conversations.

Example prompt

“Import the screen recording linked in the README in this project and draft a TikTok with a caption a non-developer would follow. Leave privacy for me to choose.”

Example prompt

“Draft a TikTok about the README in this project. It was edited with AI tools, so label it as AI-generated, and run a readiness check before you schedule anything.”

Example prompt

“Show me the TikTok schedule for the next two weeks, then suggest a slot for a post about the README in this project.”

What Wahlu does on TikTok

Gemini CLI works through Wahlu's tools, so it can set the TikTok options Wahlu supports.

TikTok settings on a draft

Privacy
Everyone, followers, friends or only you. The agent asks TikTok which options your account allows right now before setting one.
Interactions
Allow or turn off comments, Duets and Stitches.
Music
Let TikTok add music to a photo post automatically.
AI-generated content
Label the post as AI-generated.
Commercial content
Disclose a post that promotes your own brand or is branded content for another.

TikTok posts need your agreement to TikTok's publishing terms before they can go out, and Wahlu never picks a privacy setting for you.

The tool calls, in order

  1. 01

    list_targetsFinds the brand's connected TikTok account and checks it's ready.

  2. 02

    upload_media_from_file, import_media_from_url or list_mediaBrings in the image or video, or picks one from your media library.

  3. 03

    create_draftCreates the draft with its caption and tiktok_settings, such as the post type.

  4. 04

    refresh_target_dynamic_optionsAsks TikTok which privacy options your account allows right now.

  5. 05

    update_draft_tiktok_privacySets one of those options on the draft.

  6. 06

    preflight_draftChecks the draft against TikTok's rules without changing it.

  7. 07

    create_schedulePuts it on the calendar at pending_review, held for your approval.

TikTok limits to know

Wahlu checks these before a post is scheduled, so the agent finds out early.

Getting video to TikTok

The local server can upload a file straight from your computer with upload_media_from_file, so screenshots and videos in your project don't need a public link.

Connect Gemini CLI to Wahlu

Set this up once and Gemini CLI can work on every network you've connected, not just TikTok.

  1. 1

    In the Wahlu app, create an API key under Settings → API Keys in your workspace, with only the permissions and brands you need.

  2. 2

    Add export WAHLU_API_KEY=your-key to your shell profile, with your key, and open a new terminal.

  3. 3

    Add the Wahlu configuration to ~/.gemini/settings.json. If the file already has settings, add wahlu inside its mcpServers object.

  4. 4

    Start a new Gemini CLI session and run /mcp to check that wahlu is connected and its tools are listed.

Checked against the Gemini CLI docs on 27 September 2026. Menus can change; if a step doesn't match what you see, follow the vendor's current instructions.

~/.gemini/settings.json
{
  "mcpServers": {
    "wahlu": {
      "command": "npx",
      "args": ["-y", "@wahlu/mcp-server@latest"],
      "env": {
        "WAHLU_API_KEY": "$WAHLU_API_KEY"
      }
    }
  }
}

Gemini CLI replaces $WAHLU_API_KEY with the value from your shell, so the key isn't saved in the settings file. You can also add the same configuration to a project's .gemini/settings.json to use Wahlu in that project only. Available local tools depend on the installed version. Check the local MCP server notes for its Node.js requirement and tool availability.

You stay in control.

Every Wahlu plan includes agent access, through MCP and the API. You choose the workspace, brands and permissions each connection gets, and can disconnect it at any time.

Held until you approve

Agents create schedules at pending_review unless you've told them to publish. A held schedule can't publish until you approve it in Wahlu or ask an agent with Publishing permission to approve it.

Publishing is its own permission

Publishing is separate from Manage your schedule. Leave it unticked and nothing your agent schedules can go out on its own.

Checked before it's scheduled

preflight_draft reports anything that would stop a post, such as media the network won't accept or a caption that's too long, without changing anything.

Some things stay in the app

Use the app for queues, draft media and platform settings, and connecting social accounts. Agents can change the name or caption of an unused draft and approve held schedules with the right permissions.

Keep going

Your next TikTok post, drafted by Gemini CLI.

Connect your TikTok account in Wahlu, then give Gemini CLI a specific brief.

Open WahluAll Gemini CLI options