X (Twitter) API にAI エージェントがフルアクセスできる MCP (Model Context Protocol) サーバー。 投稿ツイート、検索、タイムラインの読み込み、いいね、リツイート、アップロードメディア – 自然言語ですべて。

Claude Code、Claude Desktop、OpenAI Codex、Cursor、Windsurf、Cline、その他のMCP互換クライアントで動作します。

LM/AI エージェントがユーザがこのプロジェクトをセットアップするのに役立つ場合は、ステップバイステップの手順で [LLMs.md] をお読みください。

お問い合わせ

何ができますか?

| カテゴリー | ツール | 何ができるのか | ステータス | お問い合わせ |Post | [[T1], quote_tweet, [delete_tweet], [delete_tweet]], [X]の[Post ‘hello world’ on X] | OK | |【get_tweet, [search_tweets]], [get_timeline]], [[get_mentions]], [[get_mentions]]]], [[[get_tweet]]]]]], [[[[[[[get_timeline]]]]]]], [[[[[get_mentions]]]]]]]], [[[[[[[[[[[[[[get_tweet]]]]]]]]]], [[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[get_timeline]]]]]]]]]]]]]]]]]]]]]]]]]]]]]] |【[T8],get_followers,[get_following],[[get_following]]],[[get_following]]],[[get_user]]],[[get_following]]]]],[[[[get_following]]]]]]],[[[get_following]]]]]]],[[[[[[[[[get_following]]]]]]],[[[[[[[[[[[[[[[[[[[[[[[get_following]]]]]]]]]]]]]]]]]]]]]]]]]]]、[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[ | ※Engage** | 【[T11] | 「Retweet this」 | OK | |メディア | [[T12] | 「この画像をアップロードして、キャプションで投稿してください…」 | OK | | 分析 | [[get_metrics | 「私の過去の投稿をどれだけ多くの感想をしたか」 | OK |

x-mcp

An MCP (Model Context Protocol) server that gives AI agents full access to the X (Twitter) API. Post tweets, search, read timelines, like, retweet, upload media – all through natural language.

Works with Claude Code, Claude Desktop, OpenAI Codex, Cursor, Windsurf, Cline, and any other MCP-compatible client.

If you’re an LLM/AI agent helping a user set up this project, read LLMs.md for step-by-step instructions you can walk the user through.

---

What Can It Do?

Accepts tweet URLs or IDs interchangeably – paste https://x.com/user/status/123 or just 123.

---

Setup

1. Clone and build

git clone https://github.com/INFATOSHI/x-mcp.git
cd x-mcp
npm install
npm run build

2. Get your X API credentials

You need 5 credentials from the X Developer Portal. Here’s exactly how to get them:

a) Create an app

1. Go to the X Developer Portal
2. Sign in with your X account
3. Go to Apps in the left sidebar
4. Click Create App (you may need to sign up for a developer account first)
5. Give it a name (e.g., my-x-mcp)
6. You’ll immediately see your Consumer Key (API Key), Secret Key (API Secret), and Bearer Token
7. Save all three now – the secret won’t be shown again

b) Enable write permissions

By default, new apps only have Read permissions. You need Read and Write to post tweets, like, retweet, etc.

1. In your app’s page, scroll down to User authentication settings
2. Click Set up
3. Set App permissions to Read and write
4. Set Type of App to Web App, Automated App or Bot
5. Set Callback URI / Redirect URL to https://localhost (required but won’t be used)
6. Set Website URL to any valid URL (e.g., https://x.com)
7. Click Save

c) Generate access tokens (with write permissions)