Skip to content
Agentmart
Submit a tool

Tweetkit X

Post, delete & read on X (Twitter) using your own logged-in web session — no paid API.

Connector by nsozturk · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 15
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/nsozturk-tweetkit-x

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Post, delete & read on X (Twitter) using your own logged-in web session — no paid API.

Use cases: social-media

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
17 read · 18 write · 5 delete
Secrets
2 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Python package

Tools by what they do 40

Read from the source code; the running server may list different tools.

Read 17 · Look things up without changing anything.

  • auth_status
  • get_bookmarks
  • get_followers
  • get_following
  • get_home_timeline
  • get_likers
  • get_my_tweets
  • get_notifications
  • get_replies
  • get_retweeters
  • get_tweet
  • get_user_likes
Show 5 more tools
  • get_user_profile
  • get_user_tweets
  • quote_tweet
  • search_my_tweets
  • search_x

Write 18 · Create, change, send or run things.

  • block_user
  • bookmark_tweet
  • follow_user
  • import_cookie_from_file
  • like_tweet
  • mute_user
  • pin_tweet
  • post_note
  • post_thread
  • post_tweet
  • retweet
  • schedule_tweet
Show 6 more tools
  • set_session_cookie
  • unblock_user
  • unfollow_user
  • unmute_user
  • unpin_tweet
  • unschedule_tweet

Delete 5 · Delete, drop, revoke or wipe things.

  • delete_tweet
  • delete_tweets
  • unbookmark_tweet
  • unlike_tweet
  • unretweet

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • TWEETKIT_COOKIE
  • TWEETKIT_COOKIE_KEYCHAIN

Network hosts it talks to 2

  • chromewebstore.google.com · found in code
  • github.com · found in code

Files it touches

  • Your home directory (~)
  • ~/.config/tweetkit
  • Any path the agent passes to its tools

Tools (40)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • auth_status

    Check whether tweetkit has a valid X session cookie loaded. Returns {authenticated, user_id, source_hint}. Call this first; if it is not authenticated, guide the user through set_session_cookie / import_cookie_from_file.

  • block_user

    Block @username. Confirm first.

  • bookmark_tweet

    Bookmark a tweet (private — invisible to others).

  • delete_tweet

    Delete one of the authenticated user's tweets by id. Irreversible — confirm first.

  • delete_tweets

    Delete several tweets by id. Irreversible — confirm the exact list with the user first.

  • follow_user

    Follow @username. (Reversible with unfollow_user.)

  • get_bookmarks

    Your bookmarked tweets.

  • get_followers

    A user's followers.

  • get_following

    Accounts a user follows.

  • get_home_timeline

    Your home feed. following=True → 'Following' (chronological); else 'For You'.

  • get_likers

    Users who liked a tweet.

  • get_my_tweets

    List the authenticated user's own recent tweets (newest first).

  • get_notifications

    Your notifications timeline (mentions / engagement).

  • get_replies

    Fetch a tweet's conversation (its replies).

  • get_retweeters

    Users who retweeted a tweet.

Show 25 more tools
  • get_tweet

    Fetch a single tweet by id (text, author, counts, url).

  • get_user_likes

    Tweets a user has liked.

  • get_user_profile

    A user's full profile: name, bio, follower/following/tweet counts, verified, created_at.

  • get_user_tweets

    List a given @username's recent tweets (newest first).

  • import_cookie_from_file

    Set the X session cookie from a file on disk: HAR, storage-dump .zip, or cookie JSON. Accepts: • a .har — F12 → check "Preserve log" → right-click a request → "Save all as HAR". (If Chrome scrubbed sensitive data, auth_token will be missing; fall back to set_session_cookie with a hand-copied header.) • a .zip — an export from the `storagedump` Chrome extension (https://chromewebstore.google.com/detail/storagedump/kihoghfekemdccfnpjefmggehpgnjnab), which can read the HttpOnly auth_token; contains cookies.json. • a .json — a Cookie-Editor / EditThisCookie export. Return…

  • like_tweet

    Like a tweet.

  • mute_user

    Mute @username (silent — they aren't notified).

  • pin_tweet

    Pin one of your tweets to your profile.

  • post_note

    Post a long-form (note) tweet — beyond the 280-char limit. Confirm the text first.

  • post_thread

    Post a thread: a list of tweet texts, each auto-replying to the previous one. Returns one {ok,id,url} per tweet. Stops early if a tweet fails.

  • post_tweet

    Post a tweet. Optionally attach one image (local path) and/or reply to a tweet id. Returns {ok, id, url}. This publishes to the user's real, public account — confirm the wording with the user first.

  • quote_tweet

    Quote-tweet an existing tweet (embed it with your own commentary). Optional image.

  • retweet

    Repost (retweet) a tweet.

  • schedule_tweet

    Schedule a tweet for a future unix timestamp (seconds since epoch).

  • search_my_tweets

    Find the authenticated user's own tweets matching `query`. Local filter over your timeline (X's search API is not used). Set regex=True to treat `query` as a case-insensitive regular expression — handy for cleaning up, e.g. search_my_tweets("xmr|monero", regex=True).

  • search_x

    Search ALL of X — the real search engine, not a local filter. Supports X search operators: `from:user`, `to:user`, `#hashtag`, `min_faves:100`, `filter:media`, `since:2026-01-01`, etc. Set latest=True for newest-first (default is Top). Returns tweets from across X.

  • set_session_cookie

    Set the X session cookie from a pasted `Cookie:` header — the easiest setup. HOW THE USER GETS IT (tell them this): 1. Open x.com while logged in. 2. Press F12 → the Network tab. 3. Click any request to x.com (e.g. "HomeTimeline"). 4. Under "Request Headers", find the `cookie:` line and copy its ENTIRE value. 5. Paste that whole string as `cookie_header`. The string must contain auth_token (the HttpOnly session token) and ct0 (the CSRF token). tweetkit keeps only the cookies it needs, persists them, and activates the session. The raw value is never echoed back.

  • unblock_user

    Unblock @username.

  • unbookmark_tweet

    Remove a bookmark.

  • unfollow_user

    Unfollow @username.

  • unlike_tweet

    Remove a like from a tweet.

  • unmute_user

    Unmute @username.

  • unpin_tweet

    Unpin your pinned tweet.

  • unretweet

    Undo a repost. Pass the id of the ORIGINAL tweet that was retweeted.

  • unschedule_tweet

    Cancel a previously scheduled tweet.

Compare and alternatives

    Featured in

    Signals

    Stars
    15
    Forks
    5
    Open issues
    0
    Weekly downloads
    446
    Last commit
    Sep 30, 2026 (28 days ago)
    Last release
    Jul 7, 2026 (3 months ago)
    Last package publish
    Jul 7, 2026 (3 months ago)

    From GitHub (fetched Oct 24, 2026) and the package registry.

    Details

    Registry name
    io.github.nsozturk/tweetkit-x
    Version
    0.3.0
    Auth
    API key
    Packages
    pypi tweetkit-x
    License
    MIT
    Repository
    github.com/nsozturk/tweetkit-x
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026
    Source
    Official MCP Registrygithub-graphql
    Cite this page

    Tweetkit X MCP server. Agent Mart. https://agentmart.dev/connectors/nsozturk-tweetkit-x (last updated 2026-10-24)