# X-Use - X (Twitter) MCP Server (MCP server)

> X-Use - X (Twitter) MCP Server is an MCP server that adds web browsing tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Research X (Twitter), read inboxes and review publishing through MCP. It has 179 GitHub stars, is released under the MIT license and runs locally with uvx x-use-mcp.

Connect your AI client to X research, inbox reads, and reviewed publishing. x-use is an open-source Python Model Context Protocol (MCP) server and CLI for X (Twitter). Connect Claude, Codex, Cursor or another local MCP client to profile research, inbox management and reviewed publishing. It uses your authenticated browser session, supports multiple accounts and runs locally without official X API credentials.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/ihuzaifashoukat/x-use |
| GitHub stars | 179 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | pypi: x-use-mcp |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Web & browsing |
| Latest release | v3.2.0 (Oct 13, 2026) |
| Last commit | Oct 25, 2026 |
| MCP registry name | io.github.ihuzaifashoukat/x-use |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "x-use-x-twitter-mcp-server": {
      "command": "uvx",
      "args": [
        "x-use-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env OPENAI_API_KEY=your-value --transport stdio x-use-x-twitter-mcp-server -- uvx x-use-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "x-use-x-twitter-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "x-use-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "openai_api_key",
      "description": "OPENAI_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "x-use-x-twitter-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "x-use-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "${input:openai_api_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `X_USE_HOME`: Absolute private directory for configuration, cookies, action journals and account state. Keep this stable across MCP client working directories.
- `OPENAI_API_KEY` (secret): Optional. Only needed for server-side text generation ('auto' replies, composite draft tools, background automation). Interactive MCP use is keyless because…
- `OPENAI_BASE_URL`: Optional. OpenAI-compatible endpoint, for example https://openrouter.ai/api/v1 or http://localhost:11434/v1 for Ollama. Defaults to api.openai.com.

## Similar MCP servers

- [searxNcrawl](https://appsgit.com/mcp-servers/searxncrawl): Web search via SearXNG and/or You.com, plus clean Markdown crawling via Crawl4AI. (181 stars, MIT, official, needs API key)
- [CloakBrowser MCP](https://appsgit.com/mcp-servers/cloakbrowser-mcp): Playwright MCP-compatible browser automation bridge for CloakBrowser Chromium. (172 stars, MIT)
- [Gbox](https://appsgit.com/mcp-servers/gbox): Cli and MCP for gbox. Enable AI agents to operate Android/Browser/Desktop like human. (181 stars, Apache-2.0)
- [Kreuzcrawl](https://appsgit.com/mcp-servers/kreuzcrawl): Scrape, crawl, and map websites to Markdown or JSON via local CLI. (192 stars, MIT)
- [Charlotte](https://appsgit.com/mcp-servers/charlotte): Renders web pages into structured, agent-readable representations using headless Chromium. (183 stars, MIT)
- [Scrapeless MCP Server](https://appsgit.com/mcp-servers/scrapeless-mcp-server): Web search, browser automation, scraping, crawling and CAPTCHA solving for AI agents. (169 stars, MIT, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/x-use-x-twitter-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.