How to connect X to Grok Bot

Connect Grok Bot 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

Grok is xAI's assistant, and its bot builder lets you create a personal agent that holds context, runs skills, and connects to the apps you already use through plugins.

This guide explains how to connect X to a Grok bot using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a plugin, authenticate once, then ask your bot to work with X in plain language.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate X MCP with

Why use Composio?

Composio exposes 1,700+ apps to your Grok bot through a single connection, so you get:

  • Connect to 1,700+ apps with on-demand tool loading, so you do not fill your context window with unnecessary tool definitions.
  • Use programmatic tool calling through a remote workbench, letting the model write its own code to handle complex tool chaining. This reduces back-and-forth for frequent tool calls.
  • Handle large tool responses outside the model context to keep conversations lean.

Connecting X to Grok Bot

Once Grok Bot is set up, you connect X entirely from its interface, and the whole flow takes under a minute.

Set up Grok Bot

Get access. Grok Bot is included with Cursor Ultra, Cursor Premium Teams, and SuperGrok Heavy. Get the desktop app for macOS or Windows from x.ai/bot and sign in. An iPhone companion app is also available, and your bots sync across devices.

Create a bot. Pick a suggested role or define your own, then give it a short name, one primary job, and a short description of how it should work. Focused bots work best, because a clear role gives the bot more useful context over time.

Connect X

1. Add the Composio plugin

Click the button. The Composio listing on x.ai opens and launches Grok Bot for you. If the app does not open on its own, click Add to Grok Bot.

Add to Grok Bot

Composio for Grok Bot listing on x.ai with the Add to Grok Bot button

Grok Bot opens the Composio plugin, showing its connector and skills. Click Add.

Composio plugin sheet in Grok Bot with the Add button

2. Authenticate

Go to the Installed section and click the Composio entry. You'll see its connector and skills listed.

Installed Composio plugin showing the Authenticate button

Click Authenticate. You'll be taken to the Composio consent screen. Review the access it requests and click Authorize. Composio handles the OAuth handshake for you, so you never touch API keys or tokens.

Composio authorization screen with Authorize and Deny

3. Connect your X account

Back in the chat, ask your bot to connect to X or give it any X task.

For example, ask it to:

  • "Search X posts about AI agents today"
  • "Find trending technology topics on X"
  • "Summarize recent posts from selected X users"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in your Grok bot, and your X account is ready to use.

What is Grok Bot?

Grok is xAI's assistant, available as a chat interface and a bot builder for creating personal agents that run skills and connect to external apps.

With Composio Connect, your Grok bot can securely access apps like X through MCP without you sharing account credentials directly with the agent.

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

Now that X is connected, extend your setup by connecting the other apps you already use every day, so your Grok bot can run true cross-app workflows end to end.

  • Connect Calendar to turn threads into scheduled meetings automatically.
  • Connect Slack or Teams to post summaries, approvals, and alerts where your team works.
  • Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs.
  • Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps.

Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, your bot can coordinate multiple tools safely and reliably in one conversation.

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

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