agent-twitter-client-mcp

@theo-nash

About agent-twitter-client-mcp

Model Context Protocol implementation for twitter interactions

Basic information

Category

AI & Agents

License

MIT

Runtime

node

Transports

stdio

Publisher

theo-nash

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "twitter-mcp-server-theo-nash": {
      "command": "npx",
      "args": [
        "agent-twitter-client-mcp"
      ]
    }
  }
}

Tools

14

Fetch tweets from a specific user

Fetch a specific tweet by ID

Search for tweets

Post a new tweet

Post a tweet with a poll

Like a tweet

Retweet a tweet

Quote a tweet

Get a user's profile

Follow a user

Get a user's followers

Get users a user is following

Chat with Grok via Twitter

Check the health of the Twitter MCP server

Overview

What is agent-twitter-client-mcp?

It integrates with Twitter using the agent-twitter-client package, allowing AI models to interact with Twitter without direct API access. It's for developers and AI agents that need to perform Twitter actions programmatically.

How to use agent-twitter-client-mcp?

Install via npm globally or locally, configure Twitter credentials in a .env file, then run the MCP server with agent-twitter-client-mcp or npx agent-twitter-client-mcp. Alternatively, configure it as an MCP server in Claude Desktop by adding the appropriate configuration to the claude_desktop_config.json file.

Key features of agent-twitter-client-mcp

Cookie, credentials, or API authentication
Fetch tweets, search, and post tweets
Like, retweet, and quote tweets
Get user profiles and follow users
Grok AI chat via Twitter interface
Interactive CLI test interface

Use cases of agent-twitter-client-mcp

Search Twitter for trending topics or specific queries
Post tweets with text, images, or videos via AI assistants
Analyze user profiles and follower lists
Integrate Grok's real-time Twitter data into conversations
Automate social media management tasks

FAQ from agent-twitter-client-mcp

How does agent-twitter-client-mcp authenticate with Twitter?

It supports three methods: cookie authentication (recommended), username/password with optional 2FA, and Twitter API v2 credentials.

What are the runtime requirements for agent-twitter-client-mcp?

It requires Node.js and npm. For Grok integration, agent-twitter-client v0.0.19 or higher is required.

Where does my Twitter data live?

Data is accessed through the MCP server using your Twitter credentials; the server itself does not store data persistently beyond the session.

Are there any rate limits?

Yes, Twitter imposes rate limits. Grok has specific limits: 25 messages per 2 hours for non-premium accounts; premium accounts have higher limits.

Can I use agent-twitter-client-mcp with Claude Desktop?

Yes, you can configure it as an MCP server in Claude Desktop's configuration file with the appropriate environment variables for authentication.

Comments

More AI & Agents MCP servers

Gemini MCP Server

MCP server implementation for Google's Gemini API

Perplexity Ask MCP Server

The official MCP server implementation for the Perplexity API Platform

Hass-MCP

Control and query Home Assistant from Claude and other LLMs — a Model Context Protocol (MCP) server.

Shell and Coding agent for Claude and other mcp clients

Shell and coding agent on mcp clients

MCP Server - Remote MacOs Use

The only general AI agent that does NOT requires extra API key, giving you full control on your local and remote MacOs from Claude Desktop App