Twitter MCP Server

An MCP (Model Context Protocol) server that provides tools for interacting with Twitter using the agent-twitter-client library.

Features

getTweet: Retrieve a tweet by its ID
sendTweet: Post a new tweet to Twitter

Prerequisites

Node.js (v14 or higher)
npm or yarn
Twitter account credentials

Installation

Clone this repository
Install dependencies:

npm install
# or
yarn install

Create a .env file in the root directory with your Twitter credentials:

TWITTER_USERNAME=your_twitter_username
TWITTER_PASSWORD=your_twitter_password
TWITTER_EMAIL=your_email@example.com (optional)
TWITTER_2FA_SECRET=your_2fa_secret (optional)

# Optional API credentials (used as fallback)
TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET_KEY=your_api_secret_key
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret

Usage

Running the Server

You can run the server using the FastMCP CLI tools:

# For development and testing in the terminal
npx fastmcp dev

# For visual inspection with the MCP Inspector
npx fastmcp inspect

Using the Tools

getTweet

Retrieves a tweet by its ID.

Parameters:

tweetId (string): The ID of the tweet to retrieve

Example:

getTweet({"tweetId": "1734609533274853865"})

sendTweet

Posts a new tweet to Twitter.

Parameters:

text (string): The text content of the tweet to send

Example:

sendTweet({"text": "Hello World from MCP!"})

Development

This server is built using:

FastMCP - A TypeScript framework for building MCP servers
agent-twitter-client - A Twitter client library

To build the TypeScript code:

npx tsc

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides tools for interacting with Twitter to retrieve tweets by ID and post new tweets using the agent-twitter-client library.

Related Resources

Reddit Discussion about this server

Related MCP Servers

X MCP Server
DataWhisker
A
security
A
license
A
quality
Server for X (Twitter) integration that provides tools for reading your timeline and engaging with tweets. Designed for use with Claude desktop.
Last updated -
3
8
9
JavaScript
MIT License
Twitter MCP Server
crazyrabbitLTC
-
security
A
license
-
quality
Enables interaction with Twitter through a Model Context Protocol, allowing large language models to post tweets, search for tweets, and reply to tweets.
Last updated -
25
0
10
TypeScript
MIT License
Twitter MCP Server
taazkareem
-
security
F
license
-
quality
Provides AI agents with comprehensive Twitter functionality through the Model Context Protocol standard, enabling reading tweets, posting content, managing interactions, and accessing timeline data with robust error handling.
Last updated -
4
1
JavaScript
TweetBinder by Audiense MCP Serverofficial
AudienseCo
-
security
A
license
-
quality
Allows Claude and other MCP-compatible AI models to access TweetBinder by Audiense analytics data, enabling analysis of hashtags, users, and conversations on Twitter/X with engagement metrics, sentiment analysis, and report generation.
Last updated -
1
TypeScript
Apache 2.0

View all related MCP servers

Twitter MCP Server