How to Post to X/Twitter with Hermes Agent (2026 Guide)

You just set up Hermes Agent. Now you want it to post to X.

The obvious path is the official X API — but that's $100/month for the Basic tier and requires OAuth dance that'll eat an afternoon. There's a faster way.

This guide covers how to connect Hermes Agent to X/Twitter using OpenTweet's MCP server. Three-minute setup. No Twitter API key needed.

---

Why Not Use the Twitter API Directly?

You can. The X API Basic tier ($100/month) gives you 3,000 writes/month and 10,000 reads. That's fine if you need deep access — DMs, mentions, search, full account management.

But if you just want your Hermes agent to post tweets, schedule content, create threads, and manage a queue, you're paying $100/month and wrangling OAuth 2.0 PKCE for functionality that can be done a different way.

OpenTweet sits between your agent and X. It handles the X authentication, stores your credentials securely, and exposes a clean REST API (and MCP server) that your agent calls instead. You pay $11.99/month instead of $100/month.

That's the trade-off: full Twitter API flexibility vs. a simple posting-focused bridge that costs less and takes minutes to set up.

For most Hermes users building content automation, the bridge wins.

---

What Hermes Agent Can Do with OpenTweet

Once connected, your agent has access to 30 MCP tools covering:

Posting

• Create a single tweet (draft, schedule, or publish immediately)
• Create a thread of 2–25 connected tweets
• Publish or schedule any existing draft
• Batch-schedule up to 50 tweets at once
• Upload images or video to attach to posts

Queue Management

• List all scheduled, posted, or draft tweets
• Edit drafts before they go out
• Delete posts (optionally removes from X too)

Evergreen Queue

• Add tweets to an auto-recycling pool
• Set cooldown periods (e.g., re-post every 30 days)
• Pause/unpause individual posts
• View the full history of recycled posts

Analytics

• Posting stats, streaks, and trends
• Best times to post (engagement-weighted heatmap)
• Top-performing tweets by likes, retweets, impressions
• Content gap analysis

AI Tools

• Search X for inspiration tweets
• Repurpose a tweet into new content with AI
• Generate images via Grok Imagine

---

Setup: Connecting Hermes Agent to X via OpenTweet

Step 1: Create an OpenTweet account and get your API key

Go to opentweet.io and sign up (7-day free trial, no credit card). Once you're in the dashboard:

1. Click API in the left sidebar
2. Click Create API Key
3. Copy your key — it starts with ot_

Connect your X account if you haven't already (Settings → X Account → Connect).

Step 2: Add the MCP server to Hermes config

Open ~/.hermes/config.yaml. Under the mcp_servers key, add the OpenTweet server:

mcp_servers:
  opentweet:
    command: "npx"
    args: ["-y", "@opentweet/mcp-server"]
    env:
      OPENTWEET_API_KEY: "ot_your_key_here"
    timeout: 60
    supports_parallel_tool_calls: false

If you prefer to keep secrets out of the config file, store the key in ~/.hermes/.env instead:

# ~/.hermes/.env
OPENTWEET_API_KEY=ot_your_key_here

Then reference it in config with no inline value:

mcp_servers:
  opentweet:
    command: "npx"
    args: ["-y", "@opentweet/mcp-server"]
    env:
      OPENTWEET_API_KEY: ""

Hermes merges .env values into the environment before spawning MCP server processes.

Step 3: Reload MCP without restarting

Inside any active Hermes session, run:

/reload-mcp

Hermes re-reads config and spawns the OpenTweet server. You'll see it listed as opentweet in the active servers.

Step 4: Test it

Ask Hermes to verify the connection:

Check my OpenTweet account status and tell me my posting limits

Hermes will call mcp_opentweet_get_account and return your plan, daily limit, and how many posts you've published today.

Then try a real post:

Create a tweet draft: "Just set up OpenTweet with Hermes Agent. 
3-minute setup and my agent can now post to X. Nice."

Hermes will call mcp_opentweet_create_tweet and save a draft. Approve the tool call, and you'll see it in your OpenTweet drafts.

---

Common Workflows to Try

Schedule a week of content in one conversation

I want to schedule 5 tweets this week. 
Here are my ideas: [list your ideas]
Spread them out Monday through Friday, 
morning posts between 9-11 AM.

Hermes will use mcp_opentweet_create_tweet with scheduled_date for each post.

Create a thread from a long idea

Turn this into a 5-tweet thread and schedule it for tomorrow at 10 AM:
[paste your content]

Hermes calls mcp_opentweet_create_thread with your tweets array and a scheduled_date.

Add your best posts to the evergreen queue

Show me my 10 most-liked posts from the last 90 days.
Add the top 5 to my evergreen queue with a 21-day cooldown.

Hermes chains mcp_opentweet_get_top_posts → mcp_opentweet_add_to_evergreen for each.

Find what's working and double down

What are my best posting times? 
What topics are getting the most engagement?
Draft a tweet about the top-performing topic 
and schedule it for my peak hour.

This chains analytics tools into content creation — the kind of workflow that used to require three separate tools.

---

Optional: Add a SKILL.md for Slash Commands

If you want /tweet and /schedule as quick slash commands inside Hermes, create a skill file:

mkdir -p ~/.hermes/skills/social/opentweet

Create ~/.hermes/skills/social/opentweet/SKILL.md:

---
name: opentweet
description: Draft, schedule, and post tweets through OpenTweet.io — threads, evergreen queues, and analytics included
version: 1.0.0
platforms: [macos, linux]
metadata:
  hermes:
    tags: [twitter, x, social-media, scheduling]
    category: social
    requires_toolsets: []
---

## OpenTweet Skill

Use this skill to manage your X/Twitter presence through OpenTweet.io.

### What you can do

- **Draft a tweet**: "draft a tweet about [topic]"
- **Schedule a post**: "schedule a tweet for [day] at [time]"
- **Create a thread**: "create a thread about [topic] with [N] tweets"
- **Check analytics**: "how are my posts performing this week?"
- **Manage evergreen**: "add my best tweets to the evergreen queue"

### Authentication

Requires OPENTWEET_API_KEY in ~/.hermes/.env (starts with ot_).
Get your key at opentweet.io/developer.

Skills are auto-discovered — no registration needed. Restart Hermes and /opentweet will be available.

---

Multi-Account Support

If you manage multiple X accounts (Advanced plan: 3 accounts, Agency: 10), pass the x_account_id parameter:

Post this tweet to my @secondaccount: "..."

Hermes will call mcp_opentweet_list_accounts first to resolve the handle to an ID, then pass it to mcp_opentweet_create_tweet.

---

Rate Limits

OpenTweet's API rate limits by plan:

Plan	Requests/minute	Requests/day	Daily posts
Pro	60	1,000	20
Advanced	300	10,000	100
Agency	600	30,000	300

For most Hermes agent workflows, Pro is more than enough. Advanced makes sense if you're running autonomous agents posting at high volume.

---

Hermes Agent vs. Other X Integrations

You may have seen hermes-tweet — a third-party plugin that routes through the Xquik API. That's a separate service (different credentials, different endpoints). If you've used it already, OpenTweet is a different integration that uses the MCP protocol instead of Hermes's plugin system.

The MCP approach is cleaner: Hermes treats OpenTweet tools exactly like any other capability, no separate plugin installation required.

---

Why This Matters

Hermes just became the #1 most-used AI agent in the world by daily inference volume on OpenRouter (as of May 2026). A lot of that usage is content workflows — researching, writing, organizing.

Twitter/X is the platform where most of that content eventually lands. Connecting the two means Hermes can research a topic, draft a tweet, check your best posting time, and schedule it in one unbroken workflow.

That's the use case. The setup is 3 minutes.

---

Get Started

1. Sign up for OpenTweet — 7-day free trial
2. Grab your API key from the dashboard
3. Add the MCP config to ~/.hermes/config.yaml
4. Run /reload-mcp and start posting

If you get stuck, the OpenTweet MCP docs cover every tool in detail.