MCP Directory

How to add MCP-Twikit to Claude Desktop

Search Twitter/X and read your home timeline from an MCP client, using the twikit library. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 235★ · stdio · apikey

Claude Desktop config for MCP-Twikit

npx -y @smithery/cli install mcp-twikit --client claude
{
  "mcpServers": {
    "mcp-twikit": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/adhikasp/mcp-twikit",
        "mcp-twikit"
      ],
      "env": {
        "TWITTER_USERNAME": "@example",
        "TWITTER_EMAIL": "me@example.com",
        "TWITTER_PASSWORD": "secret"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the MCP-Twikit config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm MCP-Twikit's tools appear under the 🔌 tools menu.

Before you start

  • uv / uvx (to run the server from the GitHub repo)
  • A Twitter account (username, email, and password supplied as environment variables)

What MCP-Twikit can do in Claude Desktop

search_twitter

Search Twitter for tweets matching a query. Demonstrated with arguments query (e.g. 'to:IndiHomeCare'), count (number of tweets), and sort_by (e.g. 'Latest').

get_timeline

Retrieve the latest tweets from the authenticated user's home timeline.

Security

Authenticates by logging in with your real Twitter account credentials (TWITTER_USERNAME, TWITTER_EMAIL, TWITTER_PASSWORD) supplied as environment variables, rather than an official API token. Storing and using account credentials this way carries account-security and Twitter terms-of-service risk; use a dedicated/secondary account and keep credentials out of source control.

MCP-Twikit + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the MCP-Twikit config there under the "mcpServers" key and restart the client.

Is MCP-Twikit safe to use with Claude Desktop?

Authenticates by logging in with your real Twitter account credentials (TWITTER_USERNAME, TWITTER_EMAIL, TWITTER_PASSWORD) supplied as environment variables, rather than an official API token. Storing and using account credentials this way carries account-security and Twitter terms-of-service risk; use a dedicated/secondary account and keep credentials out of source control.

Does this require the official Twitter API?

No. It uses the twikit library and logs in with your own Twitter account credentials (username, email, password) provided as environment variables.

How do I install it?

Automatically via Smithery (`npx -y @smithery/cli install mcp-twikit --client claude`), or manually by adding the provided config that runs `uvx --from git+https://github.com/adhikasp/mcp-twikit mcp-twikit` with your Twitter credentials in env.

What tools does it expose?

The documented tools are search_twitter (search for tweets by query, count, and sort order) and get_timeline (read your home timeline).

View repo Full MCP-Twikit page