Gemini CLI + Wahlu
Wahlu is one place for your social media, and Gemini CLI can use it too. Run the Wahlu MCP server on your computer with an API key, then turn the work in your project into posts for each network, upload media from your files and hold the schedule for your review.
Instagram · Facebook · TikTok · YouTube · LinkedIn personal profiles · X · Bluesky · Telegram · Discord · Tumblr
{
"mcpServers": {
"wahlu": {
"command": "npx",
"args": ["-y", "@wahlu/mcp-server@latest"],
"env": {
"WAHLU_API_KEY": "$WAHLU_API_KEY"
}
}
}
}Gemini CLI can't sign in to the hosted URL yet, so it runs Wahlu's MCP server on your computer with an API key you create and keep in your shell.
Gemini CLI runs Wahlu's MCP server on your computer, using a Wahlu API key you create.
In the Wahlu app, create an API key under Settings → API Keys in your workspace, with only the permissions and brands you need.
Add export WAHLU_API_KEY=your-key to your shell profile, with your key, and open a new terminal.
Add the Wahlu configuration to ~/.gemini/settings.json. If the file already has settings, add wahlu inside its mcpServers object.
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.
{
"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.
The local server acts with the key you give it, so create one just for this agent.
When you create the key in Settings → API Keys, choose which brands it can use.
Leave publishing off if you'd rather approve and publish from Wahlu yourself.
Revoke the key in Wahlu to cut the agent off. Your social accounts stay connected.
Example prompts and the steps to expect. These are illustrations, not recorded conversations.
Example prompt
“Read the release notes in CHANGELOG.md and draft an Instagram post and a LinkedIn post about them. Don't schedule anything yet.”
Gemini CLI reads the file, finds your connected accounts with list_targets and creates a draft for each network. Drafts don't schedule or publish anything.
Example prompt
“Upload assets/launch.mp4 and schedule a YouTube Short for Friday at 10am, held for my review.”
Gemini CLI uploads the video with upload_media_from_file, runs preflight_draft and creates the schedule at pending_review, so nothing goes out until you approve it in Wahlu.
What Gemini CLI can prepare on each network, with example prompts and each network's limits.
How your media gets to Wahlu.
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.
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.
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 separate from Manage your schedule. Leave it unticked and nothing your agent schedules can go out on its own.
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.
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.
$WAHLU_API_KEY, not in the settings file or anything you commit.Every tool, the permissions it needs and the clients that work.
Give your agent wahlu.com/connect and it follows the steps for you.
Hosted OAuth, the local package and the safety boundaries.
Gemini CLI docs: the vendor's own setup instructions.
Connect your social accounts in Wahlu, then give your agent a specific brief.