X MCP Server
A Model Context Protocol (MCP) server for X (Twitter) integration that provides tools for reading your timeline and engaging with tweets. Designed for use with Claude desktop.
<a href="https://glama.ai/mcp/servers/5nx3qqiunw"><img width="380" height="200" src="https://glama.ai/mcp/servers/5nx3qqiunw/badge" alt="X Server MCP server" /></a>
Features
- Get tweets from your home timeline
- Create new tweets
- Reply to tweets
- Built-in rate limit handling for the free API tier
- TypeScript implementation with full type safety
Prerequisites
- Node.js (v16 or higher)
- X (Twitter) Developer Account (Free)
- Claude desktop app
X API Access
X (Twitter) provides a free tier for basic API access:
Free Tier Features
- Post Limits:
- Read Limits:
- Features:
- Rate Limits:
Note: For higher volume needs, paid tiers are available:
- Basic tier ($100/month): 50,000 tweets/month, additional endpoints
- Pro tier ($5000/month): Higher limits and enterprise features
You can access the free tier at: https://developer.x.com/en/portal/products/free
Installation
- Clone the repository:
- Install dependencies:
- Build the server:
Configuration
You need to set up your X (Twitter) API credentials. Follow these detailed steps:
- Go to the Twitter Developer Portal
- Access the Free Tier:
- Create a new project:
- Create a new app within your project:
- Configure app settings:
- Set app permissions:
- Generate API Keys and Tokens:
Important:
- Keep your keys and tokens secure and never share them publicly
- You'll need all four values:
- Remember the free tier limits:
Claude Desktop Configuration
To connect the X MCP server with Claude desktop, you need to configure it in the Claude settings. Follow these steps:
- Open File Explorer
- Navigate to the Claude config directory:
- Create or edit
claude_desktop_config.json:
- Add the following configuration, replacing the placeholder values with your actual API credentials from the previous section:
- Save the file and restart Claude desktop
Note: Make sure to:
- Replace all four credential values with your actual API keys and tokens
- Keep the quotes ("") around each value
- Maintain the exact spacing and formatting shown above
- Save the file with the
.jsonextension
Available Tools
get_home_timeline
Get the most recent tweets from your home timeline.
Parameters:
limit(optional): Number of tweets to retrieve (default: 20, max: 100)
Example:
create_tweet
Create a new tweet.
Parameters:
text(required): The text content of the tweet (max 280 characters)
Example:
reply_to_tweet
Reply to a tweet.
Parameters:
tweet_id(required): The ID of the tweet to reply to
text(required): The text content of the reply (max 280 characters)
Example:
Development
npm run build: Build the TypeScript code
npm run dev: Run TypeScript in watch mode
npm start: Start the MCP server
Rate Limiting
The server includes built-in rate limit handling for X's free tier:
- Monthly limits:
- Features:
License
MIT
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature)
- Commit your changes (
git commit -m 'Add some amazing feature')
- Push to the branch (
git push origin feature/amazing-feature)
- Open a Pull Request
X MCP Server
A Model Context Protocol (MCP) server for X (Twitter) integration that provides tools for reading your timeline and engaging with tweets. Designed for use with Claude desktop.
<a href="https://glama.ai/mcp/servers/5nx3qqiunw"><img width="380" height="200" src="https://glama.ai/mcp/servers/5nx3qqiunw/badge" alt="X Server MCP server" /></a>
Features
- Get tweets from your home timeline
- Create new tweets
- Reply to tweets
- Built-in rate limit handling for the free API tier
- TypeScript implementation with full type safety
Prerequisites
- Node.js (v16 or higher)
- X (Twitter) Developer Account (Free)
- Claude desktop app
X API Access
X (Twitter) provides a free tier for basic API access:
Free Tier Features
- Post Limits:
- Read Limits:
- Features:
- Rate Limits:
Note: For higher volume needs, paid tiers are available:
- Basic tier ($100/month): 50,000 tweets/month, additional endpoints
- Pro tier ($5000/month): Higher limits and enterprise features
You can access the free tier at: https://developer.x.com/en/portal/products/free
Installation
- Clone the repository:
- Install dependencies:
- Build the server:
Configuration
You need to set up your X (Twitter) API credentials. Follow these detailed steps:
- Go to the Twitter Developer Portal
- Access the Free Tier:
- Create a new project:
- Create a new app within your project:
- Configure app settings:
- Set app permissions:
- Generate API Keys and Tokens:
Important:
- Keep your keys and tokens secure and never share them publicly
- You'll need all four values:
- Remember the free tier limits:
Claude Desktop Configuration
To connect the X MCP server with Claude desktop, you need to configure it in the Claude settings. Follow these steps:
- Open File Explorer
- Navigate to the Claude config directory:
- Create or edit
claude_desktop_config.json:
- Add the following configuration, replacing the placeholder values with your actual API credentials from the previous section:
- Save the file and restart Claude desktop
Note: Make sure to:
- Replace all four credential values with your actual API keys and tokens
- Keep the quotes ("") around each value
- Maintain the exact spacing and formatting shown above
- Save the file with the
.jsonextension
Available Tools
get_home_timeline
Get the most recent tweets from your home timeline.
Parameters:
limit(optional): Number of tweets to retrieve (default: 20, max: 100)
Example:
create_tweet
Create a new tweet.
Parameters:
text(required): The text content of the tweet (max 280 characters)
Example:
reply_to_tweet
Reply to a tweet.
Parameters:
tweet_id(required): The ID of the tweet to reply to
text(required): The text content of the reply (max 280 characters)
Example:
Development
npm run build: Build the TypeScript code
npm run dev: Run TypeScript in watch mode
npm start: Start the MCP server
Rate Limiting
The server includes built-in rate limit handling for X's free tier:
- Monthly limits:
- Features:
License
MIT
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature)
- Commit your changes (
git commit -m 'Add some amazing feature')
- Push to the branch (
git push origin feature/amazing-feature)
- Open a Pull Request