twscrape Twitter/X (read-only) MCP Server

An MCP server that reads X (Twitter): posts, threads, replies, quotes, and search. It wraps twscrape and uses your own logged-in session, so there's no paid X API and no developer account. Tools return clean markdown shaped for an agent to read, including image, video, and GIF URLs and any external links in a post. It runs locally over stdio via the published package.

People connecting web scraping tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-19 · ★ 3 · #40 OF 78 MAINTAINED WEB SCRAPING · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install twscrape Twitter/X (read-only)

before you install - you'll need

Set TWSCRAPE_TWITTER_MCP_AUTH_TOKEN before connecting.

Claude Code

claude mcp add jsilets-twscrape-twitter-mcp -- uvx twscrape-twitter-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "jsilets-twscrape-twitter-mcp": {
      "command": "uvx",
      "args": [
        "twscrape-twitter-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-06-28 - young repo, little track record yet

license MIT - declared in the repository

pypi package twscrape-twitter-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.jsilets is GitHub-verified and matches the repo owner

03 · What twscrape Twitter/X (read-only) can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.1.1 · 2026-06-28

Patch release. First release published via GitHub Trusted Publishing (OIDC) - no stored token. · Changes · README rewritten as package docs (answer-first; multi-client setup matrix for Claude Code/Desktop, Codex…

v0.1.0 · 2026-06-28

Initial release of twscrape-twitter-mcp - an MCP server that reads X (Twitter) posts, threads, replies, quotes, and search, wrapping twscrape and your own logged-in session. No paid X API. · Install · bash · uv tool…

04 · Who maintains twscrape Twitter/X (read-only)

twscrape Twitter/X (read-only) is maintained by jsilets. It's the only MCP server we track from this author; the repo dates to Jun 2026.

05 · Facts

repository: github.com/jsilets/twscrape-twitter-mcp
category: web scraping - ranked #40 of 78 actively-maintained web scraping servers as of 2026-08-25.
release cadence: 2 releases in the last 90 days (latest 2026-06-28)
registry: io.github.jsilets/twscrape-twitter-mcp (active, first published 2026-06-30)
packages: pypi:twscrape-twitter-mcp

06 · twscrape Twitter/X (read-only) FAQ

What is twscrape Twitter/X (read-only)?

Is twscrape Twitter/X (read-only) still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-19 and it shipped 2 releases in the last 90 days. We re-verify nightly.

How do I install twscrape Twitter/X (read-only)?

Run `uvx twscrape-twitter-mcp`. The README documents one environment variable (TWSCRAPE_TWITTER_MCP_AUTH_TOKEN) to set first. Set TWSCRAPE_TWITTER_MCP_AUTH_TOKEN before connecting. You can also paste the ready-made client config above.

Does twscrape Twitter/X (read-only) run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to twscrape Twitter/X (read-only)

Alternatives to twscrape Twitter/X (read-only)

Maintained web scraping servers if twscrape Twitter/X (read-only) isn't the fit.

Pairs well with

Servers that cover what twscrape Twitter/X (read-only) doesn't - only shown when the pairing reason fits the companion.

More web scraping MCP servers · Kreuzcrawl · Web Fetch MCP · Fiverr MCP Server · Xcatcher - Recent X Posts

More Python MCP servers · Secop MCP Server · Pronunciation & Voice Coach · Wikimoth · DrissionPage MCP · Juniper Routing Director MCP Server · see all