Tesselith
ProductSolutionsAI agentsCompareFree toolsBlogPricing
Join the waitlist
  1. Home/
  2. AI agents/
  3. Hermes Agent
+Hermes Agent + Tesselith

How to connect Hermes Agent to Tesselith

Add Tesselith to Hermes Agent's config and let your self-hosted agent schedule social posts from the terminal, Telegram or Discord. Hermes Agent talks to Tesselith’s MCP server, so it can draft, queue and schedule posts on every channel you’ve connected. Keep a human in the loop: publishing now and deleting always ask for your confirmation.

Join the waitlistMCP docs

What do I need before connecting?

You need Hermes Agent running on your machine or server and a Tesselith workspace on Pro, Team or Agency (every new workspace starts with a 14-day Pro trial) with at least one channel connected.

1 · Connect · a few minutes

Run this

~/.hermes/config.yaml
mcp_servers:
  tesselith:
    url: "https://api.tesselith.com/mcp"
    auth: oauth

Then run hermes mcp login tesselith, and /reload-mcp in a running session.

2 · Ask · live in Tesselith

Ask Hermes Agent to post for you

Schedule tomorrow's daily tip on Telegram at 8am.

Used Tesselith · create_draft · schedule_post

Scheduled on your Telegram channel for 8:00 tomorrow.

Also try:

  • “List my Tesselith channels.”
  • “What's queued for Mastodon this week?”
  • “Draft a week of posts from this RSS feed's latest items.”

The setup at a glance

  1. Add Tesselith to config.yaml
  2. Sign in
  3. Reload and test
  4. Ask from anywhere

One connection, every channel

Connect your accounts in Tesselith once. From then on Hermes Agent can plan and schedule for any of them, and Tesselith publishes at the time you set, even after the conversation ends.

  • XSoon
  • Instagram
  • Facebook
  • LinkedInSoon
  • Threads
  • YouTube
  • TikTokSoon
  • DiscordSoon
  • Telegram
  • RedditSoon
  • PinterestSoon
  • Bluesky
  • Mastodon
  • Dev.toSoon
  • HashnodeSoon

How do I connect Hermes Agent to Tesselith, step by step?

  1. 1. Add Tesselith to config.yaml

    Add the entry under mcp_servers in ~/.hermes/config.yaml.

  2. 2. Sign in

    Run hermes mcp login tesselith. A Tesselith window opens. Sign in, pick the workspace, untick anything you don't want the agent to do, and click Allow access. On a headless server, add --flow device to sign in from another device.

    terminal
    hermes mcp login tesselith
# headless server:
hermes mcp login tesselith --flow device

  3. 3. Reload and test

    Run /reload-mcp in your session (or restart Hermes), then hermes mcp test tesselith to see what the server answered.

    terminal
    hermes mcp test tesselith

  4. 4. Ask from anywhere

    Ask Hermes to list your Tesselith channels. If you use Hermes' gateway, you can ask from Telegram or Discord too, and Tesselith publishes at the scheduled time even after the session ends.

Can I use an API key instead of signing in?

For background jobs that can't open a browser, use a key. In Tesselith, open Settings → Developers, create an API key and tick only the scopes the agent needs. Keys start with tsl_live_ and are shown once, so store it in your password manager or a secret store.

~/.hermes/config.yaml
mcp_servers:
  tesselith:
    url: "https://api.tesselith.com/mcp"
    headers:
      Authorization: "Bearer tsl_live_…"

What can Hermes Agent do in Tesselith?

The server at https://api.tesselith.com/mcp exposes these tools. Hermes Agent only gets the permissions you approve, and never more than your own role.

Tesselith MCP tools available to Hermes Agent
What it does
list_channelsLists your connected accounts and their status
list_posts / get_postFinds posts by status or channel, or reads one
get_queueShows a channel's upcoming posts and free slots
suggest_best_timeSuggests the next free slot and your best hours
get_analytics_summaryCounts active channels, drafts and published posts
create_draftDrafts a post for one or more channels
update_postChanges a post's text, channels or media
add_to_queueGives a post the channel's next free slot
schedule_postPins a post to an exact time
upload_media_from_urlAttaches an image or video from a public URL
publish_nowPublishes within a minute, only after you confirm
delete_postDeletes a post, only after you confirm

Why is Hermes Agent not working with Tesselith?

Almost every failure is one of these. Tesselith returns a readable error, so asking Hermes Agent“what went wrong?” usually points at the right row.

Troubleshooting Hermes Agent with Tesselith
Fix
401 or 403The sign-in expired or the key is wrong. Run hermes mcp login tesselith again.
Tools are missingCheck the server isn't enabled: false and isn't filtered by tools.include or exclude; agent.log shows the connection error.
Background runs fail after a whileBackground processes can't open a browser to sign in again. Log in manually, or use an API key.
HTML instead of JSONThe URL points at a web page. It must end in /mcp.
403: your plan doesn't include API accessMCP is included on Pro, Team and Agency. New workspaces get a 14-day Pro trial; upgrade under Settings → Billing.
401: connection revoked or lost accessSomeone disconnected the assistant in Settings → AI assistants, or your role changed. Connect again and approve the workspace.
The assistant can read posts but can't scheduleYou unticked Schedule and queue on the consent screen. Disconnect and connect again, keeping that permission.
No channels foundThe assistant only sees accounts already connected in Tesselith. Connect them under Channels first.
Post scheduled at the wrong timeTell the assistant your time zone. Tesselith takes ISO 8601 times with an offset, and your workspace time zone is shown in get_queue.
429: rate limitedEach connection can make 120 requests a minute on Pro, 300 on Team and 600 on Agency. Wait for the Retry-After seconds.

Hermes Agent and Tesselith: frequently asked questions

Can Hermes Agent post while I'm offline?
Yes. Hermes hands the post to Tesselith, and Tesselith publishes at the scheduled time whether or not Hermes is still running.
Does it work with a self-hosted Hermes on a VPS?
Yes. Use the device sign-in flow or an API key, since a VPS has no browser.

Hermes Agent’s own documentation: Nous Research docs.

Connect other AI agents

ClaudeClaude CodeClaude CoworkChatGPTCodexOpenAI APICursorVS Code (GitHub Copilot)WindsurfZedClineGemini CLIOpenClawGoosen8nMistral Le ChatPerplexityManus

Ready to connect Hermes Agent?

Create your Tesselith account, connect your channels, and Hermes Agent can start scheduling in minutes.

Join the waitlist

Opening soon

Be first in when the doors open.

Join the waitlist and you'll be in the first wave of invites. One email when it opens, nothing else.

Join the waitlist
Tesselith

The social scheduler for creators, teams and agencies. One calendar, every network you post to.

Product

  • Composer
  • Calendar
  • Analytics
  • Automation
  • AI assistant
  • Posting queue
  • API & webhooks
  • MCP server
  • All features

AI agents

  • Claude
  • Claude Code
  • ChatGPT
  • Codex
  • Cursor
  • Gemini CLI
  • n8n
  • All AI agents

Solutions

  • Creators
  • Agencies
  • Small business
  • E-commerce
  • All solutions

Compare

  • Scheduler pricing 2026
  • vs Buffer
  • vs Hootsuite
  • Metricool alternatives
  • Planoly alternatives
  • All comparisons
  • All alternatives

Free tools

  • Character counter
  • Best time to post
  • UTM builder
  • Engagement rate
  • All tools

Company

  • About
  • Blog
  • Research
  • Developer docs
  • Pricing
  • Contact
  • Security
  • Status

Legal

  • Privacy
  • Terms
  • Cookies
  • Acceptable Use
  • DPA
  • Refunds

Schedule posts for

  • X (Twitter)
  • Instagram
  • Facebook Pages
  • LinkedIn
  • YouTube
  • TikTok
  • Threads
  • Bluesky
  • Mastodon
  • Pinterest
  • Reddit
  • Discord
  • Telegram
  • Dev.to
  • Hashnode
© 2026 Tesselith. All rights reserved.
PrivacyTermsCookiesSecurityData deletion
Tesselith