How to add MCP-Twikit to Cursor

Search Twitter/X and read your home timeline from an MCP client, using the twikit library. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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

1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the MCP-Twikit config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of MCP-Twikit's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the MCP-Twikit config there under the "mcpServers" key and restart the client.

Is MCP-Twikit safe to use with Cursor?

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