How to integrate X MCP with Hermes

Connect Hermes to X MCP. Search x posts about ai agents today, find trending technology topics on x, and more using natural language, with authentication handled for you.

X MCP logoX MCP
Oauth2

X MCP is X's hosted MCP server for searching posts, users, news, trends, Spaces, and communities. It provides a ready-to-use bridge for working with X data and account features.

96 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 X 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 X MCP with

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 X 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 X

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

4. Done. You're all set with a new X 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 X or request any X-related task. It will prompt you to authenticate and authorize access.

5. Done!

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

The X MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your X account. It provides structured and secure access to posts, news, communities, lists, bookmarks, chats, broadcasts, and Article drafts, so your agent can retrieve content, organize lists and bookmarks, manage conversations, and create Article drafts on your behalf.

  • Post and news retrieval: Have your agent fetch posts by ID, retrieve groups of posts, review reposts and quoted posts, see who liked a post, check recent post counts, and get news stories.
  • List and community management: Let the agent create lists, follow lists, add members, review members and followers, read list posts, and retrieve community details.
  • Bookmark organization: Direct your agent to create bookmark folders, save posts to bookmarks, and remove saved posts when they are no longer useful.
  • Chat and moderation tasks: Instruct your agent to review conversations and message requests, inspect conversation events, accept requests, archive conversations, and manage chat moderators.
  • Broadcasts and Article drafts: Have your agent retrieve broadcast details and chat history, schedule or cancel broadcasts, manage broadcast sources, and create draft Articles.

Way Forward

With X 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 X MCP action and event your agent gets out of the box.

Accept chat message request

Accept a Chat message request

Add chat moderator

Add a chat moderator

Add conversation keys

Add Conversation Keys

Add lists member

Add Lists Member

Archive chat conversation

Archive a Chat conversation

Article create draft

Create draft Article

Cancel scheduled call

Cancel a scheduled call

Chat media download

Download Chat Media.

Chat media upload append

Append Chat Media Upload.

Chat media upload finalize

Finalize Chat Media Upload.

Chat media upload initialize

Initialize Chat Media Upload.

Create lists

Create Lists

Create scheduled broadcast

Create a scheduled broadcast

Create source

Create a stream source

Create users bookmark

Create Bookmark

Create users bookmark folder

Create Bookmark Folder

Delete scheduled broadcast

Delete a scheduled broadcast

Delete source

Delete a stream source

Delete users bookmark

Delete Bookmark

Follow list

Follow List

Get broadcast

Get a broadcast

Get broadcast chat

Get broadcast chat history

Get chat conversation

Get Chat Conversation; unread state via chat_conversation.

Get chat conversation events

Get Chat Conversation Events, newest first; unread ones have an id above last_read_event_id

Get chat conversations

Get Chat Conversations; unread state via chat_conversation.

Get chat message request

Get Chat Message Request

Get chat message requests

Get Chat Message Requests

Get chat moderators

Get chat moderators

Get communities by

Get Communities by ID

Get lists by

Get Lists by ID

Get lists followers

Get Lists Followers

Get lists members

Get Lists Members

Get lists posts

Get Lists Posts

Get news

Get news stories by ID Each returned story includes a `url` deeplinking to its x.

Get posts by

Get Posts by ID Each returned post includes a `url` deeplinking to it on x.

Get posts by ids

Get Posts by IDs Each returned post includes a `url` deeplinking to it on x.

Get posts counts recent

Get Posts Counts Recent

Get posts liking users

Get Posts Liking Users

Get posts quoted posts

Get Posts Quoted Posts Each returned post includes a `url` deeplinking to it on x.

Get posts reposted by

Get Posts Reposted by

Get scheduled broadcast

Get a scheduled broadcast

Get scheduled call

Get a scheduled call

Get source

Get a stream source

Get spaces by creator ids

Get Spaces by Creator IDs

Get spaces by

Get Spaces by ID

Get spaces by ids

Get Spaces by IDs

Get spaces posts

Get Space Posts

Get trends by woeid

Get Trends by Woeid Each returned trend includes a `url` deeplinking to its x.

Get usage credits

Get usage credits

Get users bookmark folders

Get Users Bookmark Folders

Get users bookmarks

Get Users Bookmarks Each returned post includes a `url` deeplinking to it on x.

Get users bookmarks by folder

Get Users Bookmarks by Folder ID Each returned post includes a `url` deeplinking to it on x.

Get users by

Get Users by ID

Get users by username

Get Users by Username

Get users by usernames

Get Users by Usernames

Get users followed lists

Get Users Followed Lists

Get users liked posts

Get Users Liked Posts Each returned post includes a `url` deeplinking to it on x.

Get users list memberships

Get Users List Memberships

Get users me

Get Users Me

Get users me followers

Get the authenticated user's followers

Get users me following

Get the users the authenticated user follows

Get users mentions

Get Users Mentions Each returned post includes a `url` deeplinking to it on x.

Get users owned lists

Get Users Owned Lists

Get users pinned lists

Get Users Pinned Lists

Get users posts

Get Users Posts Each returned post includes a `url` deeplinking to it on x.

Get users public key

Get public keys

Get users public keys

Get public keys

Get users timeline

Get Users Timeline Each returned post includes a `url` deeplinking to it on x.

Go live scheduled broadcast

Go live on a scheduled broadcast

List broadcasts

List broadcasts

List scheduled broadcasts

List scheduled broadcasts

List scheduled calls

List scheduled calls

List sources

List stream sources

Mark chat conversation read

Mark Conversation as Read

Mark chat conversation unread

Mark Conversation as Unread

Mute broadcast chat user

Mute or time out a user in a broadcast chat

Pin list

Pin List

Remove chat moderator

Remove a chat moderator

Remove lists member by user

Remove a List member

Respond to scheduled call

Respond to a scheduled call

Schedule call

Schedule a call

Search communities

Search Communities

Search news

Search News Each returned story includes a `url` deeplinking to its x.

Search posts all

Search Posts All Each returned post includes a `url` deeplinking to it on x.

Search spaces

Search Spaces

Search users

Search Users

Send chat message

Send Chat Message

Send chat typing indicator

Send Typing Indicator

Unarchive chat conversation

Unarchive a Chat conversation

Unfollow list

Unfollow a List

Unmute broadcast chat user

Unmute a user in a broadcast chat

Unpin list

Unpin a List

Update lists

Update List

Update scheduled broadcast

Update a scheduled broadcast

Update scheduled call

Update a scheduled call

Update source

Rename a stream source

FAQ

Frequently asked questions

With a standalone X MCP server, the agents and LLMs can only access a fixed set of X tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from X 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 X tools.

Yes, absolutely. You can configure which X 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 X data and credentials are handled as safely as possible.

Start with X MCP.It takes 30 seconds.

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

Start building