01
Create, schedule, and queue posts
Create, draft, schedule, queue, or publish posts across multiple social networks using simple natural language commands.
Hermes Agent x ContentStudioSchedule social media posts with Hermes Agent
Connect ContentStudio to Hermes Agent, the open-source agent from Nous Research, with the ContentStudio CLI and skill or the ContentStudio MCP server. Then ask Hermes to draft, schedule, and approve posts from your terminal or the chat apps it's connected to.
Bash
$npm install -g contentstudio-cli $npx skills add contentstudioio/contentstudio-agent $contentstudio auth:login --api-key cs_...Publishes to:
Quick ReferenceCore CapabilitiesSetupOne more way to connectUsing the integrationSecurity & TrustPlatformsHermes Agent or OpenClawTroubleshootingMore AI AgentsFAQs
Quick Reference
Everything you need to get started
- Skill install
- npx skills add contentstudioio/contentstudio-agent
- CLI package
- contentstudio-cli
- MCP server
- https://mcp.contentstudio.io/mcp (via mcp_servers in ~/.hermes/config.yaml)
- Source (open, MIT-0)
- github.com/contentstudioio/contentstudio-agent
- Auth method
- API key (cs_…) via auth:login, or ContentStudio sign-in for the MCP route
- Requirements
- An active ContentStudio API key (CLI) or ContentStudio account (MCP)
Core Capabilities
What Hermes can do once it is connected
The ContentStudio skill gives Hermes access to the core features you use every day, so it can manage workspaces, social accounts, content, media, and approvals from a single chat.
09
Generate images and videos
Create images and videos for your posts from a prompt, or edit images with product shots, headshots, background removal, and upscaling.
02
Analytics and inbox
Hermes can pull analytics reports and triage the social inbox, replying to messages, comments, and reviews.
03
Workspaces
Switch between client workspaces, set the active one, and confirm context before any change lands.
04
Social accounts
List connected channels or generate a one-time OAuth URL to connect Instagram, LinkedIn, TikTok, and more.
05
Approvals
Review pending posts, approve or reject content, and leave feedback without opening the ContentStudio dashboard.
06
Content library
Upload local files or import straight from a URL into your ContentStudio content library, then attach them to any post.
07
Campaigns and labels
Read campaigns, content categories, labels, and team members so your agent keeps everything organized.
08
Comments and notes
Add public comments or internal notes to any post, and mention teammates.
Setup
Get started in three steps
Three quick steps are all it takes to connect Hermes Agent with ContentStudio and start scheduling your social media from your terminal or chat apps.
1
1 - Install the ContentStudio CLI
Install the CLI globally with npm. This is what Hermes uses to talk to the ContentStudio public API.
npm install -g contentstudio-cli2
2 - Add the skill for Hermes
Install the skill file so Hermes knows every ContentStudio command, including analytics, inbox, and AI images, without extra prompting. Pick Hermes Agent when the installer asks which agents to install into.
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 a sign-in with no key to manage? Add the ContentStudio MCP server to your Hermes config instead.
1 - MCP server (no API key)
MCP (Model Context Protocol) is the open standard Hermes uses to call outside tools. Add ContentStudio under mcp_servers in ~/.hermes/config.yaml, restart Hermes, and sign in with your ContentStudio account.
mcp_servers:
contentstudio:
url: "https://mcp.contentstudio.io/mcp"
auth: oauthUsing the integration
See Hermes in action
See how simple it is to manage your social media with natural language. Hermes handles everyday social media tasks, with ContentStudio doing the heavy lifting behind the scenes.
Manage Approvals
> Approve the post waiting on me and leave “looks great!” as feedback.
✓ Approved the pending post and added your feedback. It's cleared to publish.
Create a Draft
> Draft a Facebook post: “Our new blog is live!”
✓ Previewed it with --dry-run, then created a draft on your Facebook page.
Bulk Schedule
> Schedule these five posts across LinkedIn, X, and Facebook for next week.
✓ Queued all five to three platforms, dry-ran each, then scheduled them in this workspace.
Connect an Account
> Connect a new Instagram account.
✓ Generated a one-time OAuth URL. Open it to authorize, and Hermes confirms.
Manage Team
> Who's on the team for this workspace?
✓ Listed your team members and their roles, so you know who can approve and publish.
Media Upload
> Upload this product photo and attach it to a draft.
✓ Ran media:upload, then created a draft with the image attached.
Security & Trust
Hermes Agent works with guardrails on
Secure API authentication, workspace confirmation, and dry-run previews help keep every action safe, transparent, and under your control.
✓
Scoped API key: Authenticate using a single cs_ API key that connects only to the ContentStudio public API. Revoke or replace it anytime without exposing your social account passwords.
✓
Dry-run before writes: Every create, update, delete, approval, or upload action is previewed with --dry-run before it reaches the API, giving you a chance to verify changes first.
✓
Workspace confirmation: Before making any change, the skill confirms the active workspace, so posts, approvals, and updates always go to the correct client or brand.
✓
Least privilege, open source: The skill is restricted to Bash(contentstudio:*) permissions and released under the MIT license, so you can inspect, audit, and verify every line.
Platforms
Which platforms can Hermes 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 |
Hermes Agent or OpenClaw
Hermes Agent or OpenClaw?
Both are agents you can run on your own machine and talk to from chat apps, and both use the same ContentStudio CLI underneath. The difference is how the skill gets installed. Using OpenClaw instead? See the ContentStudio OpenClaw integration.
| Hermes Agent (by Nous Research) | OpenClaw (skill on ClawHub) | |
|---|---|---|
| What it's for | Open-source agent with a built-in MCP client. | Agent with the ContentStudio skill on ClawHub. |
| You say | “Schedule these five posts across LinkedIn, X, and Facebook for next week.” | “Connect a new Instagram account.” |
| Skill from | npx skills add contentstudioio/contentstudio-agent | openclaw skills install @contentstudio-official/contentstudio |
| MCP | mcp_servers in config.yaml | The same MCP link works too |
| Chat apps | Telegram, Discord, and more | Telegram, WhatsApp, Discord, Slack, Signal, Teams, Google Chat |
Troubleshooting
Quick fixes for common problems
Most issues come down to the MCP connection, the API key, or the wrong workspace.
“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 re-run auth:login.
Key not seen in a service setup
A shell export doesn't persist into a running gateway. Set CONTENTSTUDIO_API_KEY in the agent's actual environment (systemd Environment= or Docker -e), then restart the service.
RateLimitError (429)
You've hit the API rate limit. The CLI retries automatically, but AI image and video generation never auto-retry, because they are billable. Wait a moment and retry, or space out bulk jobs.
NotFoundError
The post, account, or file belongs to a different workspace. Check the active one with contentstudio workspaces:current.
ContentStudio MCP tools missing
Check that contentstudio sits under mcp_servers in ~/.hermes/config.yaml with correct YAML indentation, then restart Hermes.
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.
GeminiPlan and publish with the Gemini CLI.
Grok BotPut everyday social media tasks on autopilot.
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 Hermes Agent integration?+
It connects Hermes Agent, the open-source agent from Nous Research, to your ContentStudio account through the ContentStudio CLI and skill or the ContentStudio MCP server. Hermes can then draft, schedule, and approve posts, upload media, and manage workspaces.
How do I install the ContentStudio skill in Hermes Agent?+
Run npm install -g contentstudio-cli, then npx skills add contentstudioio/contentstudio-agent and pick Hermes Agent when prompted. Log in with contentstudio auth:login --api-key cs_....
Where do I get my ContentStudio API key?+
In your ContentStudio dashboard, go to Settings → API Keys → Generate new key. It starts with cs_.
Can I use the ContentStudio MCP server with Hermes instead of the skill?+
Yes. Add contentstudio under mcp_servers in ~/.hermes/config.yaml with the URL https://mcp.contentstudio.io/mcp, restart Hermes, and sign in with your ContentStudio account.
Can Hermes check analytics or reply to my inbox?+
Yes. With the CLI and skill, or the MCP server, Hermes can pull analytics reports and reply to messages, comments, and reviews in the social inbox.
Can I talk to Hermes from Telegram or Discord?+
Yes. Hermes talks to you over messaging platforms such as Telegram and Discord, and the ContentStudio skill works the same way there.
Is it safe to let Hermes post for me?+
The skill confirms the workspace before every change, previews writes with --dry-run, and uses a scoped API key you can revoke. Save posts as drafts if you want a person to review them first.
Can Hermes post on a schedule without me?+
Yes. Scheduled posts publish from your ContentStudio calendar on their own, even after your Hermes session ends.
Which platforms can Hermes post to?+
Facebook, Instagram, X, LinkedIn, TikTok, Pinterest, YouTube, Threads, Bluesky, Telegram, Tumblr, and Google Business Profile.
Is the ContentStudio skill open source?+
Yes. The skill and CLI are released under the MIT license at github.com/contentstudioio/contentstudio-agent, so you can inspect and audit every line.
Is it free to start?+
ContentStudio has a 7-day free trial with no credit card, so you can connect Hermes and try it on your own accounts.