Self-hosted AI agentSchedule social media posts with Hermes Agent
Hermes Agent is the open source, self improving AI agent from Nous Research. It runs on your own server, learns skills from experience, and works with 300+ AI models. Connect it to PostFast and message it from Telegram, WhatsApp, Discord, or Slack, and it schedules and publishes to all 11 platforms, straight from your phone.
Last updated
What You Can Do
Set Up PostFast on Hermes
Two ways to connect, both take about 5 minutes. Install the PostFast skill (recommended) or add the MCP server.
Option 1: Install the PostFast skill (recommended)
1. Sign up at app.postfa.st/register (7 day free trial, no credit card).
2. In PostFast, go to Workspace Settings and generate an API key.
3. On your Hermes server, set the key and install the skill:
export POSTFAST_API_KEY="your-api-key" hermes skills search postfast --source clawhub
Install the result published by @peturgeorgievv (the official one). The skill teaches your agent the full PostFast API: scheduling, media uploads, drafts, cross posting, analytics, and follower history.
Option 2: Connect the PostFast MCP server
Prefer MCP tools over a skill? Add the PostFast MCP server to ~/.hermes/config.yaml:
mcp_servers:
postfast:
command: "npx"
args: ["-y", "postfast-mcp"]
env:
POSTFAST_API_KEY: "your-api-key"Restart your Hermes session and the PostFast tools load automatically. Note for Hermes users: use this stdio server with your API key. The hosted OAuth connector at mcp.postfa.st is built for the ChatGPT and Claude apps.
Available Tools
Thirteen MCP tools ship with the PostFast server, ready for your Hermes agent to call whether you install the skill or the MCP server.
| Tool | Description |
|---|---|
list_accounts | List connected social media accounts |
get_follower_history | Daily follower/subscriber snapshots for an account, with current count and net change over a range |
list_posts | List posts with filters (IDs, platform, status, date range) |
create_posts | Create and schedule posts, batch up to 15 |
delete_post | Delete a post by ID |
upload_media | Upload a local file and get a media key (full flow) |
get_upload_urls | Get signed URLs for a manual upload flow |
list_pinterest_boards | List Pinterest boards for a connected account |
list_youtube_playlists | List YouTube playlists for a connected account |
list_gbp_locations | List Google Business Profile locations |
search_places | Search real-world places to geotag Facebook & Instagram posts |
generate_connect_link | Generate a shareable link for external clients to connect their own accounts |
get_post_analytics | Impressions, reach, likes, comments, shares, and video watch-time for published posts |
Example Messages That Work
Message Hermes Agent from Telegram, WhatsApp, Discord, or Slack.
Schedule a post from your phone
Pull analytics into chat
Draft a week, save for review
Cross-post with platform controls
Platform-Specific Controls
The create_posts tool accepts a controls parameter, so your Hermes agent can tune every platform's nuances from a single chat message. Tell it “post this as a TikTok draft so I can edit the music later” and it passes tiktokIsDraft: true automatically.
| Platform | Controls |
|---|---|
| X (Twitter) | xRetweetUrl |
| instagramPublishType (TIMELINE/STORY/REEL), instagramPostToGrid, instagramCollaborators | |
| facebookContentType (POST/REEL/STORY), facebookAllowComments, facebookPrivacy, facebookReelsCollaborators | |
| TikTok | tiktokTitle (carousels only, 90 chars), tiktokPrivacy, tiktokIsDraft, tiktokAllowComments, tiktokAllowDuet, tiktokAllowStitch, tiktokBrandOrganic, tiktokBrandContent, tiktokAutoAddMusic, tiktokIsAigc |
| YouTube | youtubeTitle, youtubePrivacy, youtubeTags, youtubeCategoryId, youtubeIsShort, youtubeMadeForKids, youtubePlaylistId, youtubeThumbnailKey |
| pinterestBoardId (required), pinterestLink | |
| linkedinAttachmentKey, linkedinAttachmentTitle | |
| Google Business Profile | gbpLocationId (required), gbpTopicType, gbpCallToActionType, gbpCallToActionUrl, event + offer fields |
Supported Platforms
Why Hermes Specifically
Hermes is for people who want a self-hosted, open-source agent they fully control, running on their own server and learning skills over time. Prefer container-level isolation with a separate key per client? NanoClaw. Want an assistant that runs locally on your laptop? OpenClaw. Work mostly from an editor or the terminal? The MCP server plugs PostFast into Claude Code, Cursor, and more.
Container-isolated alternative: NanoClaw. Runs-locally assistant: OpenClaw. Protocol-neutral view: PostFast MCP Server. CLI-first walkthrough: Claude Code integration. Compare all options on the API integrations hub.
Example Workflows
Self-hosted content OS
Run Hermes on a small VPS and message it from Telegram: "Every weekday at 8am, read my notes and draft one LinkedIn post from the best idea." Hermes drafts it, queues it through PostFast, and pings you to approve.
Team scheduler in chat
Drop Hermes into your team's Discord or Slack. Anyone can say "schedule a post about our launch," Hermes drafts and confirms in the thread, then schedules through PostFast. No dashboard needed.
Client work from your phone
Ask Hermes to generate a PostFast connect link and send it to a new client. Once they authorize their own accounts, schedule and cross-post for them from a single message, wherever you are.
Self-hosted: your keys never leave your server
Hermes runs on infrastructure you control, a VPS, a home server, or a container. Your PostFast API key lives as an environment variable on that machine, scoped to one workspace, and never touches a third-party cloud. Because Hermes is open source, you can audit exactly what it does before you run it, and regenerate the key anytime from Workspace Settings to invalidate the old one.
Frequently Asked Questions
What is Hermes Agent?
An open source AI agent by Nous Research that runs on your own server or VPS. It learns skills from experience and works with 300+ AI models, and you message it from chat apps like Telegram, WhatsApp, and Discord.
Do I need a PostFast account?
Yes. The free 7 day trial includes API access, no credit card needed. You just need an active PostFast account with an API key.
Is my API key safe?
The key lives as an environment variable on your own server and is scoped to one PostFast workspace. You can regenerate it anytime from Workspace Settings, which invalidates the old one.
Which platforms can Hermes post to through PostFast?
All 11: Instagram, TikTok, X, LinkedIn, Facebook, YouTube, Threads, Pinterest, Bluesky, Telegram, and Google Business Profile.
Can I run this from my phone?
Yes. Hermes connects to Telegram, WhatsApp, Discord, and other chat apps. You message your agent, it schedules through PostFast.
Hermes or OpenClaw?
PostFast works with both. Hermes is self-hosted on your own server or VPS; OpenClaw runs locally on your own device. Whichever agent you run, the setup takes about 5 minutes. Read the full Hermes Agent vs OpenClaw comparison, or see our OpenClaw guide.
Schedule posts from Hermes Agent
Start your 7-day free trial, generate an API key, and connect PostFast to Hermes in under 5 minutes. Running OpenClaw instead? See the OpenClaw setup guide.