SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Threads MCP with Hermes

Connect Hermes to Threads MCP. Publish today's product update on threads, find public threads posts about product launches, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Threads logoThreads
Oauth2

Threads is Meta's social network for publishing posts, managing replies, discovering content, and tracking performance. It helps creators and brands engage audiences and measure what resonates.

24 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Threads account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Threads with

ChatGPTClaude CoworkAtomic Agent

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Threads with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Threads

Ask your agent to connect to Threads, or simply request any Threads-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Threads connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Threads or request any Threads-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Threads MCP server, and what's possible with it?

The Threads MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Threads account. It provides structured and secure access to publishing, replies, public content, profile details, and performance insights, so your agent can publish posts, manage conversations, discover content, and analyze engagement on your behalf.

  • Post publishing and sharing: Have your agent publish text, image, video, carousel, quote, poll, ghost, GIF, or text-attachment posts, and optionally share them as Instagram Stories.
  • Conversation management: Let the agent reply to posts, list replies and mentions, review pending replies, and hide or unhide replies on posts you manage.
  • Public content discovery: Direct your agent to search posts by keyword or topic tag, look up public profiles, browse their posts, and find locations for post tagging.
  • Profile and post analytics: Instruct your agent to retrieve profile insights, post engagement metrics, publishing limits, and your profile details.
  • Content maintenance: Have your agent list your posts, replies, ghost posts, and reposts, then delete posts or repost content when needed.

Way Forward

With Threads connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Threads action and event your agent gets out of the box.

Create and Share Post

Create and publish a top-level Threads post and cross-share it to the linked Instagram account as a Story.

Create Post

Create and publish a top-level Threads text, image, video, carousel, quote, poll, ghost, GIF, or text-attachment post, optionally with a location tag.

Create Reply

Create and publish a reply to a Threads post, including a text, image, video, carousel, quote, poll, GIF, or text-attachment reply.

Delete Post

Permanently delete a Threads post owned by the connected profile.

Get Location

Retrieve one Threads location by ID for inspection or post tagging.

Get My Profile

Return the connected or app-scoped Threads user's profile and identity fields.

Get Post

Retrieve one Threads post by ID.

Get Post Embed

Return embeddable HTML and oEmbed metadata for a public Threads post.

Get Post Insights

Return selected lifetime engagement metrics for one post owned by the connected Threads profile.

Get Profile Insights

Return one time-window page of selected profile time-series, totals, link clicks, follower counts, or follower demographics for a Threads profile.

Get Publishing Limits

Return current usage and configured quota for Threads posts, replies, deletes, location searches, or all publishing categories.

List Ghost Posts

List active and archived ghost posts created by the connected Threads profile, one cursor page at a time.

List My Mentions

List public Threads posts that mention the connected profile, one cursor page at a time.

List My Posts

List posts created by the connected Threads profile, one cursor page at a time.

List My Replies

List replies created by the connected Threads profile, one cursor page at a time.

List Pending Replies

List one page of pending or ignored replies for an owned Threads post.

List Post Replies

Return either immediate replies or the flattened full conversation for a Threads post, one cursor page at a time.

List Public Profile Posts

List one cursor page of posts from a qualifying public Threads profile by exact username.

Lookup Public Profile

Look up a qualifying public Threads profile by exact username.

Repost Post

Repost an existing Threads post to the connected profile; this creates a visible post.

Review Pending Reply

Approve or ignore one pending reply; an ignored reply can later be approved.

Search Locations

Search Threads locations by text, coordinates, or both.

Search Posts

Search one page of Threads posts by keyword or topic tag.

Set Reply Visibility

Hide or unhide a top-level reply and its nested replies on a post managed by the connected profile.

FRAMEWORKS

How to build Threads MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Threads MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Threads MCP with Claude Cowork

Atomic Agent logo

Atomic Agent

Use Threads MCP with Atomic Agent

FAQ

Frequently asked questions

With a standalone Threads MCP server, the agents and LLMs can only access a fixed set of Threads tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Threads and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Threads tools.

Yes, absolutely. You can configure which Threads scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Threads data and credentials are handled as safely as possible.

Start with Threads.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Threads tool your agent needs.Free to start.

Start building