Tweetkit X MCP server
io.github.nsozturk/tweetkit-x·v0.3.0·10 starsPost, delete & read on X (Twitter) using your own logged-in web session — no paid API.
10 stars149 downloads/wk
Reviews
Write oneNobody has reviewed Tweetkit X yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Tweetkit X tools (40, 8 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
auth_statusCheck whether tweetkit has a valid X session cookie loaded.
block_userBlock @username. Confirm first.
bookmark_tweetBookmark a tweet (private — invisible to others).
delete_tweetwrite actionDelete one of the authenticated user's tweets by id. Irreversible — confirm first.
delete_tweetswrite actionDelete several tweets by id. Irreversible — confirm the exact list with the user first.
follow_userFollow @username. (Reversible with unfollow_user.)
get_bookmarksYour bookmarked tweets.
get_followersA user's followers.
get_followingAccounts a user follows.
get_home_timelineYour home feed. following=True → 'Following' (chronological); else 'For You'.
get_likersUsers who liked a tweet.
get_my_tweetsList the authenticated user's own recent tweets (newest first).
get_notificationsYour notifications timeline (mentions / engagement).
get_repliesFetch a tweet's conversation (its replies).
get_retweetersUsers who retweeted a tweet.
get_tweetFetch a single tweet by id (text, author, counts, url).
get_user_likesTweets a user has liked.
get_user_profileA user's full profile: name, bio, follower/following/tweet counts, verified, created_at.
get_user_tweetsList a given @username's recent tweets (newest first).
import_cookie_from_fileSet the X session cookie from a file on disk: HAR, storage-dump .zip, or cookie JSON.
like_tweetLike a tweet.
mute_userMute @username (silent — they aren't notified).
pin_tweetPin one of your tweets to your profile.
post_notewrite actionPost a long-form (note) tweet — beyond the 280-char limit. Confirm the text first.
post_threadwrite actionPost a thread: a list of tweet texts, each auto-replying to the previous one.
post_tweetwrite actionPost a tweet. Optionally attach one image (local path) and/or reply to a tweet id.
quote_tweetQuote-tweet an existing tweet (embed it with your own commentary). Optional image.
retweetRepost (retweet) a tweet.
schedule_tweetSchedule a tweet for a future unix timestamp (seconds since epoch).
search_my_tweetsFind the authenticated user's own tweets matching `query`.
search_xSearch ALL of X — the real search engine, not a local filter.
set_session_cookieSet the X session cookie from a pasted `Cookie:` header — the easiest setup.
unblock_userUnblock @username.
unbookmark_tweetwrite actionRemove a bookmark.
unfollow_userUnfollow @username.
unlike_tweetwrite actionRemove a like from a tweet.
unmute_userUnmute @username.
unpin_tweetUnpin your pinned tweet.
unretweetUndo a repost. Pass the id of the ORIGINAL tweet that was retweeted.
unschedule_tweetwrite actionCancel a previously scheduled tweet.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan8 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 80 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Tweetkit X compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 57% of 48,273 servers
- Tools
- 40
- the typical server has 7
- Tools that change things
- 20%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 10
- more than 88% of 28,534 servers
- Downloads a week
- 149
- more than 71% of 11,915 servers with a package
What its tools let an agent do: 29 read · 2 create · 4 change · 2 delete · 3 send or post
Install Tweetkit X in Claude Code, Cursor or VS Code
claude mcp add tweetkit-x -- uvx tweetkit-x
What the publisher says
From the Tweetkit X repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.nsozturk/tweetkit-x -->
tweetkit-x
Post, delete & read on X (Twitter) — from Python and as an MCP server — using your own logged-in browser session. No paid API. No developer app. No OAuth dance. Just your session cookie.
Quick start · Get your cookie · Python · CLI · MCP server · How it works · Disclaimer
Why
Since February 6, 2026, X's official API has no free tier for new developers — it's pay-per-use: ~$0.015 per post, ~$0.20 per post with a link, plus per-read charges. For publishing your own tweets (a bot posting your content, a scheduled thread, a cleanup script that deletes old posts), that's a recurring bill for something your browser already does for free.
tweetkit-x skips the API entirely. It replays the exact internal HTTP calls your browser makes when you click Post, Delete, or scroll your profile — authenticated with the session cookie you already have. Post, delete, and read the full timeline, at zero API cost.
⚠️ Automating your web session is against X's Terms of Service. This is a grey-area tool for personal automation. Account risk is entirely yours. See the Disclaimer.
Features
- ✅ Post — text, up to 4 images, GIF & video (with alt text), replies, threads, quote-tweets, long-form note tweets, and scheduled tweets
- 🗑️ Delete — one id, a list of ids, or "find matching & delete" cleanup loops
- ❤️ Engage — like, retweet, bookmark, follow, block, mute, pin — each with an undo
- 🌐 Search all of X — the real SearchTimeline (operators like from:, min_faves:, filter:media), plus local regex over your own tweets
- 📖 Read — your home feed, any timeline, a tweet's replies/conversation, followers/following, likers/retweeters, bookmarks, a user's likes, notifications, and full profiles
- 🔌 MCP server — 40 tools; drop into Claude Desktop / Claude Code / Cursor; tools that explain the cookie and set it up with one paste
- 🔑 Frictionless auth — paste a Cookie: header, drop a HAR file, or a storage-dump zip; store in a file or the macOS Keychain
- 🐍 Python API and a CLI (tweetkit …)
- 🪶 Tiny footprint — no headless browser, no Selenium
Quick start
pip install "tweetkit-x[mcp]" # or: pip install tweetkit-x (library + CLI only)
# 1. Import your session cookie (three ways — see the next section)
tweetkit import --paste # paste the Cookie: header, Ctrl-D
# or: tweetkit import --file x.com.har
# or: tweetkit import --file storagedump_x.com.zip --keychain tweetkit
# 2. Verify (no network call)
tweetkit whoami
# {"ready": true, "user_id": "1986...", "ct0_len": 160}Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Tweetkit X: common questions
- Is Tweetkit X MCP server safe?
- Mostly: it is graded B (78/100). Read the Tweetkit X safety report
- How do I install Tweetkit X?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Tweetkit X need an API key?
- Yes. The registry entry asks for
TWEETKIT_COOKIE. - Is Tweetkit X maintained?
- The last commit was 117 days ago (2026-07-07). The latest release is v0.3.0.
- What can I use instead of Tweetkit X?
- Servers from other publishers that do the same job: e2e MCP server.
- How does Tweetkit X compare with other MCP servers?
- safety score 78/100 (higher than 57% of 48,273 servers); tools 40 (the typical server has 7); tools that change things 20% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Tweetkit X
Same job from other publishers: the closest match first, then the best rated.
- e2eOpen live web and mobile app sessions from an e2e project to inspect the app and try locators.not reviewedWidely usedA