01
Plan and schedule ahead
Ask Gemini to plan a week of posts and pick the times. Save them as drafts, add them to the queue, or schedule them with ContentStudio.
Gemini x ContentStudioSchedule social media posts with Gemini
Connect ContentStudio to Gemini CLI, Google's terminal agent, with one MCP command or the ContentStudio CLI and skill. Then ask Gemini to draft, schedule, and approve posts across your social accounts from your terminal.
Bash
gemini mcp add --transport http contentstudio https://mcp.contentstudio.io/mcp # then, inside gemini/mcp auth contentstudioPublishes to:
Quick ReferenceCore CapabilitiesSetupOne more way to connectUsing the integrationSecurity & TrustPlatformsGemini CLI or Claude CodeTroubleshootingMore AI AgentsFAQs
Quick Reference
Everything you need to get started
- MCP command
- gemini mcp add --transport http contentstudio https://mcp.contentstudio.io/mcp
- CLI package
- contentstudio-cli
- Skill install
- npx skills add contentstudioio/contentstudio-agent
- Source (open, MIT-0)
- github.com/contentstudioio/contentstudio-agent
- Auth method
- /mcp auth contentstudio (MCP) or API key (cs_…) via auth:login (CLI)
- Requirements
- Gemini CLI installed in your terminal
Core Capabilities
What Gemini can do once it is connected
Gemini can write, schedule, and publish posts for every account connected to ContentStudio, attach media, run approvals, and report on results, all from the terminal you already work in.
02
Generate images and videos
Create images and videos for your posts from a prompt. The CLI also edits images: product shots, headshots, background removal, and upscaling.
03
Analytics and reports
Pull performance data for your posts and accounts, or generate a full analytics report, without opening a dashboard.
04
Uploads from disk
With the CLI and skill, Gemini can upload a screenshot or video from your project and attach it to a post.
05
Manage your inbox
Read and reply to messages, comments, and reviews across your connected networks, and tag or archive them.
06
Run approvals
Check what is waiting, approve or reject it, and leave feedback for your team.
07
Filter and edit posts
List posts by draft, scheduled, or published status, and tweak or remove unpublished ones.
08
Add comments
Add comments or internal notes to any post, no tab switching required.
09
Switch workspaces
Move between client workspaces and their campaigns, categories, and labels.
Setup
Get started in three steps
Three quick steps are all it takes to connect Gemini with ContentStudio and start scheduling your social media from your terminal.
1
1 - Install the ContentStudio CLI
Install the CLI globally with npm. This is what Gemini uses to talk to the ContentStudio API.
npm install -g contentstudio-cli2
2 - Add the skill for Gemini
Install the skill file so Gemini knows every ContentStudio command, including analytics, inbox, and AI images. Gemini CLI picks it up from .agents/skills or ~/.gemini/skills.
npx skills add contentstudioio/contentstudio-agent3
3 - Authenticate
Generate an API key from Dashboard → Settings → API Keys, then use it to authenticate the ContentStudio CLI.
contentstudio auth:login --api-key cs_...One more way to connect
Prefer the quickest setup? Add the ContentStudio MCP server with one command instead.
1 - MCP server (one command)
MCP (Model Context Protocol) is the open standard Gemini CLI uses to call outside tools. One command adds the ContentStudio MCP server. Then sign in with your ContentStudio account. No API key needed.
gemini mcp add --transport http \
contentstudio https://mcp.contentstudio.io/mcp
# then, inside gemini
/mcp auth contentstudioUsing the integration
See Gemini in action
Anything you would ask a teammate. Name the channels, the timing, and the tone, and Gemini handles the rest through ContentStudio.
Ship a Release Post With an Image
> Schedule a post to X and LinkedIn for tomorrow at 9 AM announcing the v2 release. Attach ./assets/release.png.
✓ Gemini uploads the image through the CLI and schedules both posts.
Turn a Changelog Into a Thread
> Turn the changelog in CHANGELOG.md into a 4-part X thread and a LinkedIn post. Space them across this week.
✓ A thread and a post, spread across the week in your calendar.
Schedule the Week From a File
> Read content/this-week.md and schedule each post to the account and time it names.
✓ Each post lands in your calendar on the account and time from the file.
Check How Last Week Went
> How did last week's posts perform, and which network did best?
✓ Performance for each network, with the strongest posts called out.
Clear the Approval Queue
> Show me posts waiting for approval and approve the two about the new menu.
✓ The two you named approved, the rest left pending.
Create an Image for a Post
> Create an image for our webinar announcement and attach it to Thursday's LinkedIn post.
✓ Gemini runs images:generate, gets back a media ID, and attaches the image to the post.
Security & Trust
Gemini works with guardrails on
Secure sign-in, a scoped API key, and workspace-aware actions help keep every request Gemini makes through ContentStudio safe and transparent.
✓
Standardized MCP connection: Gemini CLI reaches ContentStudio over the Model Context Protocol, an open standard that gives AI tools only the access they need.
✓
Scoped API key: The CLI route uses a single cs_ API key that talks only to the ContentStudio public API. Revoke or replace it anytime without exposing your social account passwords.
✓
No password sharing: The MCP route signs in with your ContentStudio account; your social media passwords never pass through Gemini.
✓
Approvals stay in your control: Check what is waiting, approve or reject it, and leave feedback for your team before anything goes live.
Platforms
Which platforms can Gemini post to?
Every network connected in ContentStudio, with the post types and options each one needs.
| Platform | Post types |
|---|---|
| Feed, Reel, Story, carousel, video, poll | |
| Feed, carousel, Reel, Story | |
| X (Twitter) | Feed and threads |
| Feed, document carousel, video, poll | |
| TikTok | Video and photo posts |
| Image, video, carousel pins | |
| YouTube | Videos and Shorts |
| Threads | Posts and multi-post threads |
| Bluesky | Feed posts |
| Telegram | Channel posts |
| Tumblr | Feed posts |
| Google Business Profile | Updates, events, offers, CTAs |
Gemini CLI or Claude Code
Gemini CLI or Claude Code?
Both are terminal agents, and both connect to ContentStudio the same two ways. Pick the one your team already uses.
| Gemini CLI | Claude Code | |
|---|---|---|
| What it's for | Google's terminal agent. | Anthropic's terminal agent. |
| You say | “Schedule a post to X and LinkedIn for tomorrow at 9 AM. Attach ./assets/release.png.” | “Draft 30 LinkedIn posts from these five product updates and schedule them across the month.” |
| Connects | gemini mcp add or the CLI and skill | claude mcp add or the CLI and skill |
| Signs in | /mcp auth contentstudio | On first use, in the browser |
| Best for | Teams already working with Gemini | Teams already working with Claude |
Troubleshooting
Quick fixes for common problems
Most issues come down to the MCP connection, the API key, or the wrong workspace.
ContentStudio tools don't show up
Run /mcp to check the server. If it is listed but not signed in, run /mcp auth contentstudio. Restart Gemini after adding it.
Skill not found
Run /skills list. If ContentStudio is missing, install it again and pick Gemini CLI, then run /skills reload.
“You must authenticate first”
Run contentstudio auth:status. If has_api_key is false, run contentstudio auth:login --api-key cs_... with a key from Dashboard → Settings → API Keys.
AuthError (401 / 403)
Your key is missing or invalid. Generate a fresh one in the dashboard and run auth:login again.
NotFoundError
The post, account, or file belongs to a different workspace. Check the active one with contentstudio workspaces:current.
RateLimitError
The CLI retries automatically, up to 2 times with backoff. AI image and video generation never auto-retry, because they are billable. For big jobs, ask Gemini to work in smaller batches.
Every AI agent ContentStudio connects to
One account, one set of tools. Pick the agent you already work in, or browse all of them below.
Building something custom? Browse every ContentStudio integration.
ChatGPTTurn a conversation into a week of social content.
ClaudeDraft, review, and publish directly from chat.- Claude CodeManage your social workflow from the terminal.
Grok BotPut everyday social media tasks on autopilot.
Hermes AgentConnect your terminal and favorite chat apps.
CursorTurn ideas and changelogs into social posts.- CodexLet your coding agent handle your social workflow.
OpenClawSchedule and manage posts from your own agent.
ContentStudio CLIScript posts in bash and CI, or let your agent drive.
FAQs
What is the ContentStudio Gemini CLI integration?+
It connects Gemini CLI, Google's terminal agent, to your ContentStudio account through the ContentStudio MCP server or the ContentStudio CLI and skill. Once connected, Gemini can draft, schedule, and approve posts, attach media, and pull analytics from your terminal.
How do I connect Gemini CLI to ContentStudio?+
Run gemini mcp add --transport http contentstudio https://mcp.contentstudio.io/mcp in your shell, start gemini, and run /mcp auth contentstudio to sign in.
Do I need a ContentStudio API key for Gemini?+
Not for the MCP server, which uses your ContentStudio sign-in. The CLI needs a key, which you generate under Settings → API Keys.
Should I use the MCP server or the CLI skill?+
Start with the MCP server. Add the CLI and skill when you want to upload files from disk, edit images with the AI image tools, preview requests with --dry-run, or run bulk jobs and scripts. Both cover posting, analytics, and the inbox, and you can use both.
Can Gemini upload or create images for my posts?+
Yes. With the CLI and skill, Gemini can upload a file from your computer with media:upload, or create one with images:generate, and attach it to the post.
Gemini does not show the ContentStudio tools. What should I check?+
Run /mcp to see if the server is listed and signed in, then /mcp auth contentstudio if needed. Restart Gemini after adding the server.
Can Gemini post to social media on a schedule while I am away?+
Yes. Scheduled posts publish from your ContentStudio calendar on their own, even after you close the terminal.
Which social media platforms can Gemini post to?+
Facebook, Instagram, X, LinkedIn, TikTok, Pinterest, YouTube, Threads, Bluesky, Telegram, Tumblr, and Google Business Profile.