Twitter MCP server

Connect Twitter to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Twitter MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the delete direct message tool in Twitter
  • Use the get direct messages tool in Twitter
  • Use the get timeline tool in Twitter
  • Use the get post tool in Twitter
  • Use the delete post tool in Twitter
  • Use the send direct message tool in Twitter

Supported Tools

delete_direct_message

Delete Direct Message

Delete a direct message event for the authenticated user. This removes the event from the authenticated user view only.

get_direct_messages

Get Direct Messages

Retrieve direct message events. Fetch all recent DM events for the authenticated user or messages from a specific conversation.

get_timeline

Get Timeline

Retrieve a user's timeline, mentions, or home timeline. Use this to read recent posts from a specific user, posts mentioning a user, or the authenticated user's chronological home feed.

get_post

Get Post

Retrieve one or more posts by their IDs. Returns full post details including text, author, metrics, and metadata.

delete_post

Delete Post

Delete an existing post (tweet) on Twitter/X. Only the author of the post can delete it.

send_direct_message

Send Direct Message

Send a direct message to a user or into an existing conversation. Can also create a new group conversation with an initial message.

manage_like

Manage Like

Like or unlike a post, retrieve a user's liked posts, or get users who liked a specific post.

manage_reply_visibility

Manage Reply Visibility

Hide or unhide a reply to one of your posts. Hidden replies are still accessible but not shown by default in the conversation thread.

upload_media

Upload Media

Upload image or subtitle media to X for use in posts and direct messages, or check processing status for an uploaded media item.

create_post

Create Post

Create a new post (tweet) on Twitter/X. Supports plain text posts, replies to existing posts, quote posts, posts with media attachments, and polls.

manage_retweet

Manage Retweet

Retweet or undo a retweet of a post, or retrieve users who retweeted a specific post.

get_user

Get User

Look up Twitter/X user profiles. Retrieve by user ID, username, or get the authenticated user's own profile. Returns profile details, bio, metrics (followers, following, post count), and account status.

search_posts

Search Posts

Search for recent posts on Twitter/X using a query. Supports Twitter's powerful search operators including keywords, hashtags, mentions, language filters, and boolean logic.

manage_list

Manage List

Create, update, delete Twitter/X lists, manage list members, or retrieve list details, members, and posts. A single tool for all list operations.

manage_bookmark

Manage Bookmark

Add, remove, or list bookmarked posts for the authenticated user.

manage_block_mute

Manage Block & Mute

Block, unblock, mute, or unmute a user, or list blocked/muted users.

manage_follow

Manage Follow

Follow or unfollow a user, or retrieve a user's followers or following list.

Connect Twitter to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Twitter in Metorial. In your Metorial portal, enable the Twitter MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Twitter tools.

Run Twitter through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Twitter and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Twitter tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Twitter

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Gmail

Send, read, and search email messages with support for recipients, attachments, and HTML content. Create, update, and send drafts. Manage conversation threads and organize messages with labels. Search mailboxes using Gmail query syntax (from, to, subject, date, attachment filters). Manage filters and vacation responders, update the primary address's display name and signature, and view send-as aliases, forwarding addresses, and auto-forwarding status. Import and insert messages for migration.

Google Drive

Upload, download, create, copy, move, rename, trash, and permanently delete files and folders in Google Drive. Search for files using complex queries filtering by name, MIME type, owner, modification date, labels, and other metadata. Share files and folders with specific users, groups, or domains with role-based permissions (owner, writer, commenter, reader). Manage shared drives and their members. Export Google Workspace files (Docs, Sheets, Slides) to standard formats like PDF, DOCX, and XLSX. Track file revision history and restore earlier versions. Create, read, update, and delete threaded comments and replies on files. Read label definitions and search files by label. Browse the Drive apps installed for your account. Store app-specific data in a hidden per-user folder.

Confluence

Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs.

Technical notes for Twitter

Create, read, delete, and search posts (tweets) on Twitter/X. Manage user profiles, follows, blocks, and mutes. Send, read, and delete direct messages in one-to-one and group conversations. Access home, user, and mentions timelines. Like, retweet, bookmark, and quote posts. Create and manage curated lists of accounts. Search recent posts using advanced query operators for keywords, hashtags, mentions, dates, and more. Upload image and subtitle media for post and direct message attachments. Retrieve engagement metrics including impressions, likes, and replies.

Frequently asked questions

Common questions about connecting Twitter to AI agents with Metorial.

  1. How many tools does the Twitter MCP server have?
    The Twitter MCP server exposes 17 tools, including Delete Direct Message, Get Direct Messages, Get Timeline. Each one is governed and traced through Metorial.
  2. Twitter exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Twitter MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Twitter and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Twitter MCP server yourself or use the hosted gateway.

Connect Twitter to production AI agents

See how Metorial gives your team governed access to Twitter, with tracing and security controls built in.